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Section 1 
INTRODUCTION 



The purpose of the Programmer's Reference Manual is to describe briefly the 4025 
Computer Display Terminal and its basic features, and to describe in detail the 
programming commands to which the 4025 will respond. This manual also describes 
some ways in which the 4025 might be used. 

Two assumptions are made concerning the person using this manual. First, it is assumed 
that the person is familiar with computer operations and programming. Secondly, it is 
assumed the person has access to the 4025 Computer Display Terminal Operator's 
Manual (hereafter called the 4025 Operator's Manual). 

Section 1 provides an overview of the 4025, what it is, and what it can do. Detailed 
descriptions of commands and options are given in later sections. 



GENERAL DESCRIPTION 

The 4025 Computer Display Terminal is a microprocessor-based refresh-style terminal 
designed especially for text editing, form fillout, and graphic display. Internal operations of 
the 4025 are controlled by a microprocessor and its associated firmware. The 4025 is not 
intended to be a stand-alone system. It can be connected to a host via a full duplex RS- 
232 line, or through optional current loop or polling adapter interfaces. It can act as a 
glass teletype or smart terminal. 

The 4025 consists of a display unit, and a keyboard attached by a cable to the display 
unit. The display unit contains a CRT display, microprocessor and supporting electronics, 
RS-232 (standard) communications interface, and optional communications/peripheral 
interfaces. 
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4025 Display 

The 4025 display is a video monitor with several visual enhancements. Brightness and 
contrast are manually controlled. In addition, the background can be set by commands to 
one of three brightness levels. Text may be displayed normally, underlined, inverted (dark 
text on bright background), or blinking. These features can be used to emphasize portions 
of text and to make form fields easy to recognize. In addition to the standard character 
font, optional fonts are available and other fonts may be user-defined. An option gives the 
4025 graphic ability, including vector generation and addressable screen coordinates. 
Text on the 4025 screen is also stored in a display memory. The standard 4025 has 4K 
bytes of display memory, and options are available to expand this to 32K. If the display 
memory contains more text than the screen can hold, one may scroll through this memory 
to display various portions of the text. 



4025 Keyboard 

The keys on the 4025's keyboard fall into three categories: ASCII keys, cursor/numeric 
pad keys, and function keys. 

The ASCII section of the keyboard resembles an ordinary typewriter keyboard. Each key 
in this section (except the BREAK key) sends a character of the ASCII code to the 
computer. The ASCII code is described in Appendix B. The BREAK key sends a "break" 
signal which interrupts the computer's current operation. 

The cursor/numeric pad is a group of eleven keys to the right of the ASCII section of the 
keyboard. This group of keys can function as a cursor pad or a numeric pad. When the 
NUMERIC LOCK function key is off (unlighted), the group functions as a cursor pad. In 
this mode the four keys marked with arrows move the cursor, and the two keys marked 
with triangles scroll the text. When the NUMERIC LOCK function key is on (lighted), the 
oroun functions as a numeric oad. In this case the shifted versions of the appropriate pad 
keys will move the cursor and scroll the text. For example, when the NUMERIC LOCK 
function key is lighted, SHIFT-8 moves the cursor up. 
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The fsjnntjQn kgw nrnnn consists of th6 ERASE ke v the PT ( n ad terminator) ke u , and the 
sixteen keys along the top of the keyboard. These sixteen keys are divided into four 
groups of four each. Each key in the rightmost group includes an LED which indicates the 
status of that key. The ERASE key erases the memory scroll into which the keyboard is 
currently typing (workspace or monitor). The PT (pad terminator) key is the large key to 
the right of the cursor/numeric pad. It has no meaning until programmed by the host or 
the operator. The sixteen keys along the top of the keyboard have the following meanings: 



F1 - 


Not Assigned 


F2- 


Not Assigned 


F3- 


Not Assigned 


F4- 


Not Assigned 


F5- 


HOME 


F6- 


Not Assigned 


F7- 


Not Assigned 


F8- 


SEND" 


F9- 


DELETE CHARACTER 


F10- 


DELETE LINE 


F11 - 


ERASE and SKIP 


F12- 


INSERT LINE 


F13- 


INSERT MODE* 




TTY LOCK* 




NUMERIC LOCK/LEARN* 




COMMAND LOCK OUT /STATUS 



(* - lighted) 

(** - This key has no meaning until programmed by the host or 

operator) 



NOTE 

If the 4025 contains Option 10 or Option 1 1, the meaning assigned to 
some of the function keys will be different. The reader should refer to the 
4024/4025 Option 10 Polling Interface Instruction Manual for relevant 
information. 

Most of the keys on the 4025's keyboard can be programmed to have different meanings 
than those indicated above. A discussion of this is found in the "Programmable 
Keyboard" section below. The 4025's keyboard is described in detail in the 4025 
Operator's Manual. 
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Communications Interface 

The standard 4025 interface is RS-232 ASCII, full duplex. Other interfaces, such as half 
duplex, GPIB, etc., are available as options. 

For the standard interface, the operator uses commands to specify relevant parameters 
such as local or remote echoing, prompt sequences, parity checking, transmit and receive 
baud rates, etc. 

For the optional interfaces, the operator uses commands to specify parameters that apply 
to the particular interface, such as character sets, special characters, block header and 
terminator characters, buffer sizes, etc. 

Another option makes the 4025 capable of operating as a polling slave in a multidrop 
environment. 



4025 FEATURES 

This section describes the basic features of the 4025 which one must understand in 
order to program the 4025 effectively. 



Programmable Keyboard 

Each of the keys on the 4025 (except the TTY LOCK, NUMERIC LOCK/LEARN, 
COMMAND LOCKOUT, SHIFT, CTRL, and BREAK keys) may be programmed by the 
operator or the host using the LEARN command. The LEARN command assigns a 
character string to the programmed key. That character string is generated whenever that 
key is pressed. This allows commonly used character strings, words or commands to be 
invoked with a single keystroke. This also allows the user or host to move characters to 
other keys in order to configure the keyboard for specific applications. Key programming 
may assign different meanings to the shifted and unshifted versions of the same key. For 
example, "A" and "a" may be programmed to have different meanings. For a detailed 
description of the LEARN command, see Section 2, "Command Descriptions." 



The Workspace and the Monitor 

The 4025's display memory is divided into two sections or scrolls - the workspace and 
the monitor. The operator or programmer may divide the screen into two areas to display 
text from each of these scrolls. 



1-4 @ 4025 PROGRAMMER'S REFERENCE 



INTRODUCTION 



inc uypci aico uu^ia yo ical i i win n ic wuirvofjairc i tno at oa 10 uoou IU Ul caic, cull, Ul 

review text or forms. Text in the workspace is transmitted to the host only when the SEND 
command is executed. 

The lower area displays text from the monitor. This area is normally used to display 
terminal commands, and messages to and from the computer. It cannot contain forms or 
graphics. In general, the monitor allows (1 ) the operator to communicate with the terminal 
or the host without this interaction being written over the workspace display, and (2) the 
host to issue error messages or prompts without writing over the workspace display. 

When the terminal is first turned on, or is reset, the entire screen is devoted to the 
monitor. The numbers of lines on the screen devoted to the monitor and workspace are 
set by the MONITOR command or the WORKSPACE command. These commands also 
allow one to specify whether input and/or output is directed into the monitor or into the 
workspace. 



Buffered Mode and Unbuffered Mode 

The 4025 can operate either in unbuffered mode or buffered mode. These modes of 
operation differ in the way that the 4025 processes information. 

When the 4025 is in unbuffered mode, each character entered in the monitor is 
immediately transmitted to the host. Under these circumstances, it is not possible to 
locally edit the information displayed on the monitor. As soon as a character appears on 
the 4025 screen, it has already been sent to the computer. If text is entered into the 
workspace, however, it is not sent to the computer until the SEND command is given and 
executed. Then the entire contents of the workspace are sent to the computer in a 
continuous stream. 

When the 4025 is in buffered mode, characters entered in either the workspace or 
monitor are stored in the display memory until RETURN is pressed. Anytime before 
RETURN is pressed the current line can be edited locally. When RETURN is pressed, the 
4025 marks the end of the current line with an end-of-line (EOL) string and stores the line 
in a transmit buffer. The line remains in the transmit buffer until it can be processed. 

The contents of the transmit buffer are processed on a first in-first out basis. When the 
computer is ready to accept another line, it transmits a prompt string to the 4025. When 
the 4025 detects this prompt, it examines the oldest line in the transmit buffer. If this line 
is a command, the 4025 executes the command. If the line is text destined for the 
computer, the 4025 transmits that line of text to the computer. In either case, the 4025 
waits for another prompt from the computer before processing the next line in the transmit 
buffer. 
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Prompt strings vary with the program, operating system, and computer. The PROMPT 
command allows any string to be designated as the prompt string for the 4025. (See 
Section 2, "Command Descriptions.") 

The 4025 powers up in unbuffered mode, and will remain in unbuffered mode until 
instructed otherwise. The only way to put the 4025 in buffered mode is to use the 
BUFFERED command. Either the computer or the operator must send !BUF YES or its 
equivalent to the 4025. (We assume here that "!" is the command character. See Section 
2, "Command Descriptions.") In contrast, there are four ways to return the 4025 to 
unbuffered mode: 

1. Send !BUF NO, or its equivalent. 

2. The operator may press the RESET button. 

3. The operator may press the BREAK key twice in quick succession. 

4. The operator may turn the power off, then on again. 

Methods 2-4 will change other parameters in the 4025, however, and these should be 
used only when appropriate. 

Scrolling, Tabs, and Margins 

Both the monitor and the workspace can each hold more text than the screen can display 
at one time. If the portion of the screen devoted to the workspace is full, the workspace 
automatically scrolls up when the next line of text is printed on the screen. Text scrolled 
off the screen is saved in the 4025's display memory so long as that memory capacity is 
not exceeded. The scrolled text can be viewed by scrolling back and forth, using the 
appropriate keys or commands, usee aescripnons oi me ur, uwwm, nwr a« u ,,^...- 
commands in Section 2.) The operation for the monitor is similar, except that text scrolled 
off the screen is discarded automatically when the 4025 needs that memory space for 
something else. When all available memory has been used, the monitor is reduced to one 
line. After that, if additional information is entered, the 4025 writes over the last line of the 
display and over the last line of data stored in memory. 

If the user types beyond the right margin, the 4025's bell rings. If he continues typing until 
the cursor reaches the right edge of the screen, the cursor wraps around to the left 
margin of the next line. Pressing RETURN also causes the cursor to move to the left 
margin of the next line. The margins are set by the MARGIN command. 
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stops. All stops are set or redefined each time this command is given. Individual stops 
cannot be changed without resetting all stops. Pressing the TAB key or sending the TAB 
character to the 4025 causes the cursor to move to the next tab stop. (This action is 
modified if the 4025 is in form fillout mode. See the following discussion of form fillout 
mode.) 



FORM FILLOUT MODE 

A form consists of one or more lines, with each line divided into one or more areas called 
fields. Some fields will display labels or questions relating to other fields which are blank. 
The blank fields will be filled in by the operator. A sample form asking for a name, address 
and ZIP code is shown below. 



Name: 
Address: 








City: 






State : 


^^■^■IH ZIP:|H 


11551-1 



Figure 1-1. Sample Form. 

Form fillout allows the operator or the host to display a form in the workspace display, fill 
out the blanks in the form, and transmit the results to the host or another device for 
storage or further processing. 

When a form is being filled out and the results are transmitted, the 4025 must be in form 
fillout mode (and in unbuffered mode). At all other times the 4025 should not be in form 
fillout mode. In particular, when the form is created, or sent to or from the 4025, the 4025 
must not be in form fillout mode. 

To define a form, each field in a line must be defined separately. The form definition 
proceeds line by line until the entire form has been defined and sent to the host. Fields 
are defined using the ATTRIBUTE command (Section 2, "Command Descriptions"). Every 
field possesses location, length, logical attributes, visual attributes, and font attributes. 
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Logical attributes define restrictions on the type of data that may appear in a given field. 
The logical attributes that a field may have are protected (P), modified (M), alphanumeric 
(A) and numeric (N). Alphanumeric, numeric and protected are mutually exclusive 
attributes. When the 4025 is in form fillout mode, protected fields cannot be typed into or 
changed. The default attributes of a field are unprotected, unmodified and alphanumeric. 

Visual attributes describe the appearance of the field. The visual attributes are standard 
(S), underlined (U), inverted (I), and enhanced (E). The standard attribute is defined as the 
absence of all other attributes. It also is possible to blink the field between any 
combination of visual attributes (e.g., underscore to enhanced, etc.). 



Filling Out a Form 

Once a form has been displayed on the screen, and the 4025 has been placed in form 
fillout mode, the operator may fill out the form. Pressing the HOME key moves the cursor 
to the beginning of the first unprotected field on the screen. The operator may type into 
the field until it is full. When the field is full, the cursor moves to the beginning of the next 
unprotected field on the screen. If the operator wishes to go to the next field before 
completely filling the current field, he presses the TAB key and the cursor goes to the 
beginning of the next unprotected field. 

The cursor may be moved freely about the page using the cursor movement keys. If, 
however, the operator attempts to type into a protected field, the bell rings. If the pressed 
key was a character key, the character is placed at the beginning of the next unprotected 
field. The bell also rings when an invalid character is typed (such as a letter in a numeric 
field). 

Whenever the operator enters data in a field, the 4025 marks that field as modified. The 
next SEND MOD command causes all modified fields to be sent to the host. The fields 
ssrst are then marked as unmodified so that the u are not transmitted a n ain. Thus, the user 
may enter the whole page and transmit it with the SEND MOD command, or he may use 
the SEND MOD command after entering each field and cause the fields to be transmitted 
separately. If the host detects an error in a field, and notifies the operator, the operator 
may correct his error, and then give the SEND MOD command again. This will cause only 
the corrected field to be sent to the host. 
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The SEND key has no predefined meaning. The operator or host may 
program the SEND key to give the SEND command or the SEND MOD 
command. If SEND MOD is used, only text modified since the last 
transmission is sent. See Section 2, "Command Descriptions." 



When the form has been filled out correctly, the operator gives the SEND command. 
Unprotected text in the display list is read into a transmit buffer and sent to its destination 
at host command. Thus the operator or the host program can erase the unprotected text in 
the display list (using the ERASE command), and the operator may then fill out the form 
again. 



INPUT REQUESTED BY THE HOST 

When the 4025 is in unbuffered mode, all text generated in response to input request 
commands is transmitted immediately to the host. (The same applies to keyboard text.) In 
buffered mode, all requests for text are processed immediately, but the data is held in a 
transmit buffer until a prompt is received from the host; then the contents of that buffer 
are sent a line at a time. 

When the 4025 is in buffered mode, any commands or text typed on the keyboard go into 
the transmit buffer. When a prompt is received from the host (and no input request 
commands were received from the host in the last transmission) the transmit buffer is 
processed, local commands are executed, and the text is sent to the host. The user must 
terminate his transaction by sending the end-of-message character (a carriage return). It 
is important to note that commands to the 4025 entered from the keyboard are not 
executed until a prompt is received from the host. 

The commands that may request input are SEND and REPORT. A user-defined or system- 
defined prompt sequence is also recognized, and indicates that any typed text should be 
returned. 

If the terminal detects a prompt from the host, any data in the transmit buffer is 
processed, the results are sent to the host, any terminal commands in the buffer are 
executed, and remaining text transmitted. 
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SEND 



REPORT 



For a description of this command, see Section 2, "Command Descriptions." 
If the 4025 is in buffered mode, the transmission is done a line at a time, with 
the terminal waiting for a prompt after sending each line. 

The status of the indicated device is returned to the host. Besides the 
physical devices in the terminal system (such as the display unit), several 
logical entities may have their status interrogated. The format of the report 
depends on the particular device reporting; however, the format is fixed for 
each device, so that no grammatical analysis by the host program is required. 
(See Section 2, "Command Deceptions.") 



In buffered mode, information generated by a REPORT command is not sent to the host 
until a prompt is received. Note further that several REPORT commands can be sent 
during a single transmission; again, all the returned text is stored in a buffer and sent as a 
unit when the prompt is received. In unbuffered mode, however, an end-of-line string is 
appended to each report, and the data is transmitted immediately. 
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COMMAND FORMAT 

Each 4025 command is represented by an English style ASCII string. In addition, the 
graphics commands have equivalent counterparts on existing 401 0-series terminals, and 
may be represented using the established 401 0-style codes. (See Section 3 for a 
discussion of the graphics options.) 

Command Format - A 4025 command consists of four parts: 

a) The command character, 

b) the keyword, 

c) the command parameters, and 

d) the command terminator. 

The command character is a unique, user-selectable character that does not normally 
occur in text. When the terminal recognizes this character, it knows that a keyword 
immediately follows. In this description, an exclamation point "!" will be used for the 
command character. The "!" is the standard command character when the 4025 is 
shipped from the factory. If the command character is changed by the operator or 
programmer, the 4025 will remember the new command character even when power is 
turned off and back on again. 

The keyword is a single word that describes the operation to be performed. This word can 
be spelled out entirely, or it can be truncated to at least the first three letters. The 
keyword must immediately follow the command character. There must be no spaces or 
other characters between the command character and the keyword. 

The command parameters, if any, follow the keyword. The type and number of such 
parameters depend on the particular command. Parameters may be numbers, character 
strings, or words. Words may be abbreviated to their first letter. Parameters are separated 
from the keyword and from each other by separators. A separator can be a comma, or one 
or more spaces. (There are exceptions to this, notably the ATTRIBUTE command.) 

The last character in a command, whether a parameter or the final character of a keyword, 
is separated from subsequent text by a terminator. A terminator can be either a semicolon 
or a carriage return, <CR>. Commands are not executed, however, until <CR> is 
detected. 
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Examples: 

!ERASE<CR> (no parameters) 
".MARGIN 10,70;!STOPS 20,30,40,60 <CR> 
!JUMP10,3<CR> 
!DLINE<CR> 

Exceptions: 

The 4025's firmware will allow certain variations: 

1 . Command terminators can be omitted if the command to be terminated is followed by a 
command character. For example: 

(ERASE; IDOWN 5 can be abbreviated to:!ERA!DOW 5. 

2. Separators between a keyword or alphabetic parameter and a numeric parameter can 
be omitted. For example: 

IDOWN 5 can be written as IDOW5 or IHCOPY 3,W can be written as IHC03W. 

3. Separators followed by + or - characters may be omitted. For example: 

IRVECTOR +5,0,-20,-1 1 0,+ 35,-1 1 may be written as 
IRVE + 5,0-20-1 10 + 35-1 10. 

4. Some 4025 commands can be continued from one line of program code to the next by 
inserting a continuation character in the command. There are two cases where this can 
be done. 

(1 ) In a VECTOR or RVECTOR command. The ampersand, "&", can be inserted after a 
numeric parameter and the command continued to the next line. 

Example: 

In BASIC, the statement: 

1 00 PRINT "IGRAPHIC 1 ,20;!VECTOR 0,0,1 75,1 75,0,1 75,0,0;" 

can be written as: 

1 00 PRINT "IGRAPHIC 1 ,20;!VECTOR 0,0,&" 

101 PRINT "175,1 75,0,1 75,0,0;" 
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(2) !n commands that take delimited ASCII strin n s as n arameters (the EOF EOL 

LEARN, PROMPT, and STRING commands). A delimited string can be divided into 
two delimited strings on consecutive lines of program code using the hyphen, "-", 
as a continuation character. 

Example: 

In BASIC, the statement: 

200 PRINT "ILEARN F1 /ISEND ALL;!ERA W;/" 

can be written as: 

200 PRINT "ILEARN F1 /ISEND ALL;/-" 

201 PRINT "/IERAW;/" 

The continuation character should not be inserted: 

(a) Between the command character and the command keyword. 

(b) Within the keyword. 

(c) Within a numeric parameter or between a plus or minus sign and a number. 

(d) Within delimiters of an ASCII string. 



NOTE 

Often, considerable reduction in line transmission can be achieved using 
these techniques. However, one should use caution when compacting text 
in this way. 

5. In addition to the above exceptions, individual commands may tolerate minor variations 
in syntax. For details, see descriptions of the individual commands. 



Selecting the Command Character 

The choice of command character for a particular applications program should be made 
carefully. Command characters should not be sent to the 4025 in any role except as 
command characters. If the command character is sent in another context, the 4025 and 
the operator will be confused. For example, in a text editing program the exclamation 
point, "!", would be a risky choice for the command character. In such a program this 
character might occur in text as a punctuation mark. Another character should be chosen. 
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CAUTION < 



< 



Symbols such as "carriage return" or "space," which are normally used 
during host/terminal communications, should not be used as command 
characters. 



Command Characters and Keyboard Lockout 

It may be desirable to prevent an operator from issuing arbitrary commands to the 4025 
during an applications program, and still allow him to issue host-determined commands or 
command sequences to the 4025. For example, during a form fillout program, the operator 
should not be able to modify the form itself, but should be able to give the SEND MOD 
command. 

Key programming can accomplish this. Suppose "!" is the command character. If the host 
sends "ILEARN ! 00;" to the 4025, the "!", or SHIFT-1 key will be programmed to generate 
an ASCII null character. This prevents the operator from using the "!" key to generate the 
command character. Yet the host can send command characters to the terminal as usual, 
and function keys can be programmed to issue commands. Only the operator's ability to 
issue the command character from the keyboard is impaired. At the proper time, control of 
the 4025 can be returned to the keyboard by sending "ILEARN ! 33;" from the host. 



A Note on Syntax Notation 

When an expression is enclosed in square brackets, "[...]," that expression is optional. It 
need not appear for a valid command to be given. (It may have to appear, however, for the 
command you give to have the effect you desire.) When an expression is not enclosed in 
square brackets, that expression is necessary to define a valid command. For example, 
"IBEUU" means that either "!BEL" or "IBELL" will cause the 4025's bell to ring; "!BE" is 
not sufficient. Likewise, 

"!ATT[RIBUTE]" means that "ATT", "ATTR" "ATTRIBUTE" are all valid keywords for 

the ATTRIBUTE command. The characters "AT" are not enough; "ATT" is the minimum. 

Whenever the notation "[...|...p" is used following a command, it signifies that one choice 
is to be made from the list of strings separated by vertical bars. Note that square brackets 
may be nested. Thus, '!FOR[M][Y[ES]|N[0]]" means that: 

"IFOR", "IFOR N", "IFORM NO", "IFOR Y", "IFOR YES" 

are all valid commands. 
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Ex n ressions enclosed in pointed brackets, "<„>", are parameter names. (The notation 
<CR> means carriage return.) When one gives a specific command, the string name 
inside "<...>" will be replaced with one choice from a specified set of valid replacements. 
Replacements may be alphabetic or numeric strings. The set of valid replacements for the 
name enclosed by "<...>" is listed or described for each command. When a listing is 
used, the assignment operator ":=" appears, with "<...>" to the left, and the set of valid 
replacements to the right. The set is enclosed with square brackets "[...]", and members of 
the set are separated by vertical bars, '!" 

For example, we have the foiiowing syntax: 

"!BAC[KTAB] [<count>]<CR> 

where <count> : = [+][1|2|3...|32767]." 

The first line indicates that <count> is optional. The second line indicates that when 
<count> is specified, it should be a positive integer not greater than 32767, preceded by 
an optional "+" sign. 

COMMAND DESCRIPTIONS 

ATTRIBUTE 

Syntax: 

!ATT[RIBUTE] [<font>][<logical>][<visual> [- <visual>]] <CR> 

where: 

<font> : = <a number from to 31 >, and denotes the character font, 

< logical > := [M][A|N|P] and denotes the logical attributes where M = modified, A = 
alphanumeric, N = numeric, P = protected; and 

< visual > := [S|E[U][l]|U[E][l]|l[U][E]] and denotes a set of visual attributes where S = 
standard, E = enhanced, U = underlined, and I = inverted. 

Examples of syntax: 

!ATT AE<CR> <logical> = <A>, <visual> = <E> 

!ATT 3 E-UKCR> <font> = <3>, <visual #1 > = <E>, <visual #2> = <UI> 

!ATT MPS-U<CR> <font> = <0>, <logical> = <MP>, 

<visual #1> = <S>, <visual #2> = <U> 
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Restrictions on syntax: 



No spaces are allowed between the letters designating the logical and visual attributes. 



Action: 



This command inserts a field attribute code into the workspace's display list, at the 
current location of the cursor. The field attribute code marks the beginning of a new field 
in that line of the workspace, and designates those attributes which apply to that field and 
are different from the attributes of the field preceding it (if any) in that line. 

Field attributes fall into three categories: character font attributes, logical attributes, and 
visual attributes. Each line in the workspace begins with the default attributes: character 
font 0, alphanumeric logical attribute, standard visual attribute. In scanning the line from 
left to right, when an attribute code is encountered, it denotes the start of a new field in 
the line and may change one or more of the three classes of attributes. If a class of 
attributes (font, logical, or visual) is not mentioned in an ATTRIBUTE command, then that 
command does not change that class of attributes; the attributes of the preceding field in 
the line remain in effect. 



Font attribute: 



A number from to 31 designating the character font which is to 
be used for displaying characters in the following field. The 
default character font is Font 0, the standard font. Font 1 is the 
"rulings" font. Other fonts may be determined by ROMs inserted 
in the Character Set Expansion Board (Option 31 ) or may be 
defined by the user with SYMBOL commands (requires Option 
23, 24, 25, or 26.) 



Logical attributes: 

M Modified When this attribute is attached to a protected field, that field will 

be sent to the host in the next SEND MOD operation. 

A Alphanumeric The default logical attribute. Specifies an unprotected field into 
which any alphanumeric character may be entered. 



N Numeric 



Specifies an unprotected field into which numerals and special 
characters may be entered, but not letters of the alphabet. 



Protected Specifies a protected field. In form fillout mode, and only in form 

fillout mode, protected fields cannot be erased or typed into. 
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All logical attributes have effect only when the 4025 is in form fillout mode. 



Visual attributes: 
S Standard 

E Enhanced 

I Inverted 
U Underlined 



The default visual attribute. Displays characters as light on a 
dark background. This is the absence of the other visual 
attributes. 

Displays the dark background of each character as slightly 
brighter than usual. (The absolute brightness and contrast are 
still manually controlled by the operator, however.) 

Displays characters as dark on a light background, rather than 
the standard light on dark background. 

Displays an underline under all characters and spaces in the 
field. 



NOTE 

Combinations of the E, I, and U visual attributes are permitted, e.g., 

!ATTEKCR> 
!ATTEU<CR> 
!ATTIU<CR> 
!ATTEIU<CR> 



The display may "blink" (alternate) between two visual attributes or sets of visual 
attributes. To accomplish this, specify both sets of attributes in the ATTRIBUTE 
command, separating them by a hyphen: 

!ATT E-I<CR> Blinks between enhanced and inverted. 

!ATT l-E<CR> Blinks between inverted and enhanced. 

!ATT S-IU<CR> Blinks between standard and "inverted with underline." 
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BACKTAB 

Syntax: 

where: 



!BAC[KTAB] [<count>]<CR> 



<count>: = [+][l|2^i..l32767] 



Action: 

Like pressing the BK TAB key <count> times; performs <count> backtab operations. 

When not in form fillout mode, each backtab operation moves the cursor to the preceding 
tab stop, or to the start of the line if there are no tab stops to the left of the cursor. The 
cursor will not jump to a preceding line of text, regardless of how many backtabs are 
attempted. 

When in form fillout mode, each backtab operation moves the cursor to the beginning of 
the unprotected field in which it is located. If the cursor is already at the start of an 
unprotected field, or if it is not inside an unprotected field, a backtab operation moves the 
cursor to the start of the preceding unprotected field. If the cursor is already at the start of 
the first unprotected field in the form, a backtab operation leaves the cursor where it is. 

Default: 

If the <count> parameter is omitted, it is assumed to be 1 . 

BAUD 

Syntax: 

!BAU[D] <parameter> [parameter>]<CR> 

where: ; 

ft. 

< parameter > : = [0|50|75|1 1 0|1 50|1 34fc00|600|l 200|1 800|2400K800|9600] 
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This command sets the baud rate. If only one parameter is given, it is used to set both the 
transmit and receive baud rates. If two parameters are given, the first is for transmit and 
the second for receive. A parameter of means an external clock is used. 

Examples: 



!BAU 300<CR> 



Sets both transmit and receive rates to 300 baud. 



!BAU 300, 600<CR> Sets transmitting rate to 300 baud, receiving rate to 600 

baud. 



Default: 



If no parameter is specified, the command has no effect. 



BELL 



Syntax: 



Action: 



!BEL[L]<CR> 



Sounds the terminal's bell. (This may also be accomplished by sending the ASCII BEL 
character, a CTRL-G.) 



BUFFERED 

Syntax: 



Examples of Syntax: 



!BUF[FERED] [ Y[ES] I N[0] ]<CR> 



!BUFFEREDYES<CR> 
!BUFY<CR> 
!BUFN<CR> 
!BUF<CR> 
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Action: 

Controls buffered mode. If Y (for Yes) is specified, the terminal is placed in buffered 
mode. If N (for No) is specified, the terminal is placed in unbuffered mode. 

When a BUFFERED YES command is given by the host, each subsequent line of text 
typed on the keyboard will be held until the host has sent a prompt requesting that line. 
When a BUFFERED YES command is typed on the keyboard, the same is true, except that 
the 4025 behaves as if it has already received the first prompt. That is, the first line typed 
on the keyboard will be sent as soon as it is terminated, without waiting for a prompt; but 
subsequent lines will each require a prompt before they are sent. 

Default: 

If no parameter is specified, Y (for Yes) is assumed. 



CLEAR 

Syntax: 

!CLE[AR]<CR> 
Action: 
Removes all the programmed key definitions. 

COMMAND 

Syntax: 

!COM[MAND] <parameter><CR> 

where: 

<parameter> may be a single ASCII character, or the ASCII Decimal 
Equivalent of that character, a two- or three-digit number between 00 and 
127. 



Examples of syntax: 



ICOMMAND #<CR> 
!COM35<CR> 
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If the parameter is not a letter of the alphabet, the space following the keyword may be 
omitted. 

Action: 

Sets the command character to the character specified by the parameter. If the parameter 
is a single character, that character becomes the new command character. If the 
parameter is a two or three digit number, that number is the ASCII decimal equivalent of 
the new command character. 

Default: 

If no parameter is specified, this command has no effect; the command character remains 
as it was. 




Symbols such as "carriage return" or "space", which are normally used 
during host/terminal communications, should not be used as command 
characters. 



COPY (Printer) 

(Requires Option 3.) 
Syntax: 

ICOPM < WORKSPACE] | HtOST] > P[RINTER]<CR> 
Examples of Syntax: 

ICOPY WORKSPACE PRINTER<CR> 

!COPW,P<CR> 

!COPHP<CR> 

Details of this command will be supplied in the final version of this manual. 
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OCHAR (Delete Character) 



Syntax: 



Examples of syntax: 



!DCH[AR] [<count>]<CR> 



!DCHAR<CR> 
!DCH3<CR> 

Action: 

This command causes the <count> characters at the cursor position (and immediately 
following, if <count> is bigger than 1) to be deleted. Characters to the right of the cursor 
in the same field (if in form fillout mode) or line (if not in form fillout mode) are shifted to 
the left one place. In form fillout mode, characters will not be deleted from a protected 
field or from an adjacent unprotected field. 

This command is equivalent to pressing the DELETE CHAR key <count> times. 



Default: 

If the <count> parameter is omitted, it is assumed to be one. 

DELAY 

Syntax: 

!DEL[AY] <time><CR> 

where: 



Examples of syntax: 



<time> is an integer from to 32767. 



!DELO<CR> 
!DEL15<CR> 
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Action: 

Sets the turnaround delay to at least <time> milliseconds. In buffered mode, after a 
prompt is detected, the 4025 waits this length of time before transmitting anything. 



DFONT (Delete Font) 

(Requires Option 23, 24, 25, or 26.) 

Syntax: 

!DFO[NT] <font number><CR> 

where: 

<font number> is an integer in the range from 1 to 31 . 

Action: 

This command deletes the symbol definitions in the specified programmable font. The 
space may be used for graphics when the font is deleted. 

DISCONNECT 

(Requires Option 1.) 
Syntax: 

!DIS[CONNECT]<CR> 

Action: 

Sends a signal to the modem, causing it to disconnect the 4025 from the communications 
line. (Turns off the "data terminal ready" signal on the RS-232 interface for about one 
second. This should cause the the modem to disconnect from the telephone line.) 
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DLINE (Delete Line) 

Syntax: 

!DLI[NE] [<count>]<CR> 

Action: 

This command causes <count> lines at the cursor position to be deleted. If the 4025 is 
in form fillout mode, all unprotected character positions in the lines are changed to 
blanks. However, if the terminal is not in form fillout mode, the lines themselves are 
deleted and lines below are rolled up to fill the gap. 

Default: 

If <count> is omitted, it is assumed to be one. 

DOWN 

Syntax: 

!DOW[N] [<count>]<CR> 

Action: 

This command causes the cursor to move down <count> lines. If the cursor is on the 
bottom line of the text window, the text is rolled up. If there is no text available below the 
current line, a new blank line is created at the bottom of the page to allow rollup to occur. 

Default: 

If <count> is omitted, it is assumed to be one. 

DUPLEX 

(Requires Option 1.) 
Syntax: 

!DUP[LEX] [<fulldup>|<halfdup>]<CR> 
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where: 

<fulldup>:= F[ULL] 

<halfdup>:= H[ALF][N[ORM]|S[UPERVISOR]][P[ROMPT]|L[INE]] 

(Parameters must be separated from the keyword and each other by spaces or commas.) 



Examples of syntax: 



!DUPLEX<GR> 

(DUPLEX FULL<CR> 

!DUP<CR> 

!DUPF<CR> 

!DUPH<CR> 

!DUPHS<CR> 

!DUPHSP<CR> 

!DUPHSL<CR> 

!DUPHN<CR> 

!DUPHNP<CR> 

!DUPHNL<CR> 



Action: 



This command sets the 4025 for either full or half duplex data communications. Full 
duplex mode is used with full duplex communication lines, which permit both terminal and 
host to transmit at the same time. Half duplex is used with half duplex communications 
lines, over which only one device (terminal or host) may transmit at a time. 

If half duplex is specified, either normal or supervisor mode may be chosen. Also, in half 
duplex mode one may specify whether the line turnaround condition (rather than the 
prompt string) is to be used as the prompt in buffered operation. 

Default: 

If no parameters are specified, full duplex operation is assumed. If half duplex is chosen, 
but neither "normal" nor "supervisor" mode is specified, "supervisor" mode is assumed. If 
half duplex is chosen, and neither "prompt" nor "line" is specified, "line" is assumed; the 
line turnaround is taken as the prompting condition. 
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ECHO 

Syntax: 

!ECH[0] [L[OCAL]|R[EMOTE]]<CR> 

Action: 

This command controls keyboard echoing when text from the keyboard is directed to the 
monitor and the 4025 is in unbuffered mode. If L (for Local) is specified, characters typed 
on the keyboard will be displayed (echoed) on the screen. If R (for Remote) is specified, 
typed characters will not be displayed. (In "remote echo" data communications, the host 
or modem would echo each character back it receives it from the 4025. It is the host- or 
modem-supplied "remote echo" that is displayed on the screen.) 

Default: 

If neither L nor R is specified, L is assumed. 

EOF (End-of-File) 

(Requires Option 3.) 
Syntax: 

!EOF[<string>]<CR> 
where <string> may be: 

(a) One or more delimited ASCII strings. A delimited ASCII string consists of a 
string of any printable ASCII characters (except the command character) with a 
delimiter at each end. The delimiter may be any printing character except the 
command character, space, comma, semi-colon, numerals, or letters of the 
alphabet. 

(b) A sequence of ADE values (ASCII Decimal Equivalents) separated by spaces or 
commas. 

(c) Any combination of (a) or (b). 
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Exam n !6S of s u ntax: 

!EOF"abc"<CR> 
!EOF/abc/<CR> 
!EOF17 18 19<CR> 
!EOF/abc/17,18,19<CR> 

Restrictions on syntax: 

The <string> may define a maximum of ten ASCII characters. 

Action: 

This command sets the string which is used to indicate end-of-file when copying text from 
the host to a 4642 Line Printer. (See the COPY command.) 

Default: 

If no <string> is specified, "slash, asterisk" (/*) is assumed. 

EOL (End-of-Line) 

Syntax: 

!EOL [<string>]<CR> 
where < string > may be: 

(a) One or more delimited ASCII strings. A delimited ASCII string consists of a 
string of any printable ASCII characters (except the command character) with a 
delimiter at each end. The delimiter may be any printing character except the 
command character, space, comma, semi-colon, numerals, or letters of the 
alphabet. 

(b) A sequence of ADE values (ASCII Decimal Equivalents) separated by spaces or 
commas. 

(c) Any combination of (a) or (b). 
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Examples of syntax: 

!EOL/abc/<CR> 
!EOL 13 10<CR> 
!EOL/abc/ 13,10<CR> 

Restrictions on syntax: 

This command may define a string of no more than 1 characters. 

Action: 

This command sets the end-of-line string, which the 4025 sends to the host at the end of 
each line of text. When typing on the keyboard, with text from the keyboard directed to the 
monitor and the terminal in unbuffered mode, the end-of-line string is sent whenever 
RETURN is pressed. When text from the workspace is sent (with a SEND command), the 
end-of-line string is appended at the end of each line of text. Similarly, in buffered mode, 
as the host requests each line of text from the 4025, the 4025 sends that line and 
appends an end-of-line string at the line's end. 

The 4025 remembers its end-of-line string even after power has been turned off. 

Default: 

If no <string> is specified in the EOL command, the 4025 sets the end-of-line string to 
"carriage return." 

ERASE 

Syntax: 

!ERA[SE] [ WORKSPACE] | MtONITOR] | GRAPHICS] ]<CR> 

Examples of syntax: 

IERASE WORKSPACE<CR> 
!ERAM<CR> 

Restrictions on syntax: 

In order to specify G (for Graphics), Option 23, 24, 25, or 26 must be installed. 
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Action: 

This command erases the specified area. If W or M is specified, the entire workspace or 
monitor display list is erased. If G is specified, the entire graphics area, including text, is 
erased. (ERASE G can also be performed by sending ESCAPE-FORM FEED.) 

Default: 

If no parameter is specified when this command is typed on the keyboard, the command 
erases whichever scroii (workspace or monitor) into which text from the keyboard is 
directed. If no parameter is specified when this command is given by the host, the 
command erases whichever scroll (workspace or monitor) into which text from the host is 
directed. 



FIELD 

Syntax: 

!FIE[LD] [<character>]<CR> 

where: 

<character> may be a single printing ASCII character or a 2- or 3-digit 
number from 00 to 1 27. 

Action: 

This command sets the character which is used to precede fields of a form when they are 
transmitted to the host. If no value is supplied, then no character is inserted before a field, 
and trailing blanks are sent. The <character> parameter can be represented as an ASCII 
character or a 2- or 3- digit ASCII Decimal Equivalent. Common values of this parameter 
are TAB, CR, and US. 

Default: 

If no parameter is specified, it is assumed to be NULL. 
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FORM 

Syntax: 

!FOR[M] [Y[ES]|N[0]]<CR> 

Action: 

This command controls form fillout mode. If Y (for Yes) is specified, the 4025 is placed in 
form fillout mode. If N (for No) is specified, the 4025 is removed from form fillout mode. 

Default: 

If no parameter is specified, Y is assumed. 

GRAPHIC 

(Requires Option 23, 24, 25, or 26.) 
Syntax: 

!GRA[PHIC] <beg row> <end row> [<beg col>[<end col>]]<CR> 

where: 

<beg row>, <end row>, <beg col>, <end col> are positive integers 
designating rows and columns of the workspace. 

Restrictions on syntax: 

The parameters must be separated from each other by commas or spaces. The <beg 
col> and <end col> parameters must be no more than 80. Also, <beg row> must be 
less than <end row>, and <beg col> less than <end col>. The <end row> parameter 
may not exceed the <beg row> parameter by more than 52. 

Action: 

This command sets up a graphic region in the workspace display list and clears it of old 
characters. If there is no graphic memory available, then an error message, "NO GRAPH 
MEM," is printed in the monitor. A maximum of 53 lines may be included in the graphics 
area. 
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If the <begcol>,or <begcol> and <endcol> parameters are omitted, they are 
assumed to be 1 and 80, respectively. 

Affect on other commands: 

The effect of editing keys and editing commands is changed somewhat by the presence 
of the graphic area. The following describes the major differences. 

Delete Character: Inside a graphic area, the character is replaced by a 
space. 

Delete Line: On a line which passes through a graphic area, characters 
outside the graphic area are deleted. The appearance of the graphic area 
does not change. 

Erase & Skip: In a line that passes through a graphic area, only characters 
outside the graphic area are affected. 

Form Fillout Mode: All locations within the graphic area are protected. If a 
graphic area is less than 80 columns wide and no form exists in the side 
area(s), then the side areas are unprotected by default and text may be 
entered into them. To prevent text from being entered into these areas, 
they must be protected or the graphic area expanded to include all 80 
columns. 

Erase Workspace: This erases the entire workspace, including the graphic 
area definition. A new .'GRAPHIC command must be given before further 
graphics may be displayed. 

Cursor movement and typing: Cursor movement and typing are not 
affected by the presence of the graphics area. A character has priority 
over graphics inside the graphics area. 

Attribute codes: Inside a graphic area, only font codes may be given in the 
ATTRIBUTE command. All other attributes are ignored. Any visual 
attributes (enhanced, etc.) which are in effect at the left edge of the 
graphic area will also affect the corresponding "stripe" running through 
the graphic area. Any logical attributes and font codes in effect at the left 
edge of the graphic area do not affect the area itself, but characters to the 
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right of the window are given the same font and logical attributes in effect 
before the window was created. It is possible to create a new graphic area 
on the display when there is still one present. If this happens, all further 
graphics commands will affect only the new area. The old area becomes, 
for all intents and purposes, a "text" area, since it cannot be further 
modified graphically. It does, however, maintain its integrity against editing 
in the same way as the active graphic area. When creating a new graphic 
area, it is desirable not to overlap it with other existing graphic areas, 
particularly if the graphic areas are fairly wide. Overlapping graphic areas 
can cause the limit on information in one character row to be exceeded, 
causing undesired results on the display. 



GTEST (Graph Test) 

(Requires Option 23, 24, 25, or 26.) 

Syntax: 

!GTE[ST]<CR> 

Action: 

Executes a WORKSPACE operation, destroying the entire contents of the workspace 
and monitor and causing the entire screen to be used for displaying the monitor. Then 
tests the graphic memory. After a delay of about 1 5 seconds (while it performs the test), 
the monitor displays the test results, starting with character set 1 and proceeding to 
character set 31 . If no RAM is installed for a particular character set, the 4025 displays a 
"NO RAM" message. If RAM is installed, each character is tested twice (each bit is tested 
for both 1 and 0), and the 4025 displays "OK" for each of these two tests if the RAM 
passes the test. If the RAM for a particular character set fails the test, the 4025 displays 
"BAD RAM" together with an error code for use by service personnel. 



2-22 



4025 PROGRAMMER'S REFERENCE 



COMMANDS AND PROGRAMMING 



nowri vrieiru uopy; 

(Requires Option 40.) 
Syntax: 

!HCO[PY] [<count>] [ WORKSPACE] | M[ONITOR] |S[CREEN] ]<CR> 
Examples of syntax: 

IHCOPY WORKSPACE<CR> 
!HC0 2M<CR> 

Restrictions on syntax: 

The <count> parameter is ignored if S (for Screen) is specified. 

Action: 

This command copies <count> pages from the specified area to a TEKTRONIX 4631 
Hard Copy Unit, beginning with the first visible line in that area. If fewer than <count> 
pages exist in the display list, then only that number of pages in the display list is printed; 
however, at least one page of hard copy will be produced. If S (for Screen) is specified, 
the lines copied are exactly what is visible on the screen; <count> has no meaning in 
this case. 

Each page of copy continues until it includes 53 lines of text or until an ASCII form feed 
character is encountered as the first character of a line. The line of text containing such a 
form feed is not copied on the current page. 

Default: 

If <count> is omitted, it is assumed to be one. 

If the HCOPY command is typed on the keyboard, and neither W nor M nor S is specified, 
then a copy is made of whichever scroll (workspace or monitor) receives text from the 
keyboard. 

If the HCOPY command comes from the host, and neither W nor M nor S is specified, then 
a copy is made of whichever scroll (workspace or monitor) receives text from the host. 
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HRULE (Horizontal Rule) 

(Requires Option 32.) 
Syntax: 

!HRU[LE] <row> <column> [<length> [<width>] ]<CR> 

Restrictions on syntax: 

All parameters are positive integers. The <column> parameter must not exceed 80. The 
sum of <column> and <length> must not exceed 81. The <width> parameter, if 
specified, must be either 1 or 2. 

Action: 

Draws a horizontal ruling in the workspace. The first character of the ruling is inserted at 
the row and column specified by the <row> and <column> parameters, and the ruling 
continues to the right for a total of <length> character cells. The ruling is a single line if 
< width > is one, and a double line if < width > is two. 

Default: 

If < length > or < width > are omitted, they are assumed to be one. 

ICHAR (Insert Character) 

Syntax: 

!ICH[AR]<CR> 

Action: 

The terminal is put in insert mode, as if the INSERT MODE key had been pressed. 
Henceforth, all characters to the right of the cursor are moved to the right when a 
character is received from the host or typed on the keyboard. This mode of operation is 
terminated on receipt of a cursor movement control character or a cursor movement 
command, or when the operator types a cursor movement character or moves the cursor. 
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Syntax: 

!ILI[NE][<count>]<CR> 

Action: 

This command inserts <count> blank lines into the text, immediately below the line 
holding the current cursor position. The cursor is left at the beginning of the newest line. 
Existing lines of text below the cursor position are scrolled down to make room for the 
inserted blank lines. This command makes it easy to insert new text between lines of old 
text. Use the ILINE command to create several blank lines at the desired location. The 
operator may then type into the blank lines, overwriting the blanks with new text. The 
DLINE command can then be used, if necessary, to delete unwanted blank lines left over. 

NOTE 

For text editing applications, the first line entered into the workspace 
should be blank. Then if new text must be inserted above the old text, the 
cursor is moved to the beginning of the workspace and the ILINE 
command creates space for the new text. If the first line of the workspace 
already contains text, this procedure inserts blank lines below the first line 
of old text, rather than above it. 

Default: 

If <count> is omitted, it is assumed to be one. 
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JUMP 

Syntax: 

!JUM[P][<row> [<column>] ]<CR> 

Restrictions on syntax: 

The two parameters must be positive integers; < column > may not exceed 80. 

Action: 

Moves the workspace cursor to the location specified by the <row> and <column> 
parameters. The workspace will be scrolled up or down if necessary to display the cursor 
in the specified location. 

The <row> and <column> parameters are absolute workspace coordinates. If the 
workspace cursor is at the beginning of the fifth line, the command !JUM 3<CR> moves 
the cursor to the beginning of the third line. The command !JUM 1 <CR> always moves 
the cursor to the beginning of the first line of the workspace. If the 4025 is in form fillout 
mode, the command sequence !JUM 1 ;!TAB<CR> will send the cursor to the beginning 
of the first unprotected field in the form. This command sequence is equivalent to 
pressing the HOME key in form fillout mode. 

Default: 

If <column> is omitted, the cursor is put at the beginning of the desired row. If <row> is 
also omitted, row 1 is assumed. 

NOTE 
JUMP cannot be used to move the cursor in the monitor. 

LEARN 

Syntax: 

!LEA[RN] <key> [<string>]<CR> 
The <key> parameter may be any of the following: 
(a) A single ASCII character. 
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(b) A 2- or 3-digit ADE value (ASCII Decimal Equivalent) from 00 to 1 27. 

(c) A mnemonic representing a non-ASCII key (function key or cursor/numeric pad 
key: 



F1 - F13 



S1 
PO 



S13 
P9,P.,PT 



Function keys 1 through 13. (Function key 13 is the Insert 
Mode key, which can be programmed.) 
Function keys 1 through 13 with SHIFT depressed. 
Numeric pad and terminator. 



(d) A "pseudo-ADE value" representing a non-ASCII key: 



128 Function 

129 Function 

130 Function 

131 Function 

132 Function 

133 Function 

134 Function 

135 Function 

136 Function 

137 Function 

138 Function 

139 Function 

140 Function 



Key 1 



Key 
Key 
Key 
Key 



2 

3 
4 
5 



Key 6 
Key 7 
Key 8 
Key 9 
Key 10 
Key 11 
Key 12 
Key 13 



160 Pad Key 

161 Pad Key 1 

162 Pad Key 2 

163 Pad Key 3 

164 Pad Key 4 

165 Pad Key 5 

166 Pad Key 6 

167 Pad Key 7 

168 Pad Key 8 

169 Pad Key 9 

170 Pad Key . 

1 71 Pad Terminator Key 



1 44 SHIFT- 

1 45 SHIFT- 

1 46 SHIFT- 
147SHIFT- 
148SHIFT- 
149SHIFT- 
150SHIFT- 
151 SHIFT- 
152SHIFT- 
153SHIFT- 
154SHIFT- 
155SHIFT- 
1 56 SHIFT- 



Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 
Function 



Key 
Key 
Key 
Key 
Key 
Key 
Key 
Key 8 
Key 9 
Key 10 
Key 11 
Key 12 
Key 13 



172 ERASE 

173 SHIFT-ERASE 
174BKTAB 
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The <string> parameter may be any of the following: 

(a) One or more delimited ASCII strings. A delimited ASCII string consists of a 
string of any printable ASCII characters (including spaces, semicolon, commas, 
etc., including the command character) with a delimiter on each end. The 
delimiter can be any printing character except the command character, carriage 
return, space, comma, semi-colon, numerals, or letters of the alphabet. 

(b) A sequence of ADE values (ASCII Decimal Equivalents) separated by commas 
or spaces. 

(c) A sequence of pseudo-ADE values representing non-ASCII keys, separated by 
commas or spaces. These pseudo-ADE values are the same as those described 
above for the <key> parameter. 

(d) Any combination of (a), (b), or (c). 

The <string> parameter may not include function key mnemonics like those described 
under (c) for the <key> parameter. 

When the LEARN command is given from the host computer, it may be continued from one 
line to another by inserting a hyphen (-) outside a delimited ASCII string as the last 
character on the line before the carriage return which terminates the line. (This may not 
be done in LEARN commands typed on the keyboard.) This causes the <CR>, up to one 
LF, and all NUL, rubouts, and syncs to be ignored until another character is seen. 

Examples of syntax: 

!LEA[RN] <key> [<string>]<CR> 

ILEARN F1 33 /WOR 20 H K/ 13<CR> <F1 > designates Function Key 1. 

<String> designates the !WOR 20 H K 
<CR> command. 33 is the ADE for "!". 

ILEA 172 13<CR> <1 72 > designates the ERASE key. 

< 1 3> designates "carriage return." 

Action: 

This command redefines the key designated by its <key> parameter, assigning to it the 
string of ASCII characters and/or keystrokes designated by the <string> parameter. 
Since <string> may include the command character, the key may be programmed to give 
any command or series of commands. 



2-28 @ 4025 PROGRAMMER'S REFERENCE 



COMMANDS AND PROGRAMMING 



There are onlv a few ke v s which ma u not be n ro n rammed, or included as elements in the 
programming of other keys. These are: 

• The rightmost three of the lighted function keys - TTY LOCK, NUMERIC LOCK, 
COMMAND LOCKOUT and their shifted versions, LEARN and STATUS. 

• CTRL, SHIFT, and BREAK. 
Default: 

If the <string> parameter is omitted, the key named in the <key> parameter is assigned 
its default meaning. 

Examples: 



ILEARN Q /abc/<CR> 



Assigns the meaning "abc" to the upper- 
case Q key. (Does not affect lowercase q. 



ILEA F1 33 /WOR 20 H K/ 13<CR> 



Assigns Function Key 1 the meaning: "! 
WOR 20 H K <CR>" Henceforth, press- 
ing that key gives the WORKSPACE 20 H 
K command. 



ILEA 172 13<CR> 



Redefines the ERASE key to mean "car- 
riage return." 



ILEA 172<CR> 



Causes the ERASE key to revert to its 
original meaning. 



ILEA 156 "You shouldn't" - 
"press SHIFT when you" - 
"press INSERT MODE."<CR> 



Programs SHIFT-INSERT MODE 
(SHIFT-Function Key 13) 
to give an error message. This example 
illustrates how to continue the key defini- 
tion from one line to another. (This tech- 
nique may not be used when typing the 
command on the keyboard.) 
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LEFT 

Syntax: 

!LEF[T] [<count>]<CR> 

Action: 

Moves the cursor to the left <count> character positions. (This command is equivalent 
to pressing the "left cursor" key <count> times.) If <count> is great enough to require 
the cursor to move to the left of the left margin, it will wrap around to column 80 of the 
previous line. If necessary, rolldown will occur, but not past the top of the workspace. 

Default: 

If <count> is omitted, it is assumed to be one. 

LINE 

(Requires Option 23, 24, 25, or 26.) 
Syntax: 

!LIN[E] [<linetype>]<CR> 
where <line type> may be one of the following: 

• A digit from 1 to 8. 

• The letter E. 

• The letter P. 

Action: 

Sets the type of line that subsequent VECTOR commands draw. Line type 1 is a solid line, 
and types 2 through 8 are different styles of dashed lines. Line type E causes subsequent 
VECTOR commands to draw "erase vectors" which erase lines previously drawn. Line 
type P causes subsequent VECTOR commands to plot isolated points. 

Default: 

If no <line type> is specified, it is assumed to be one (solid line). 
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MARGINS 

Syntax: 

!MAR[GINS] [<left marg> [<right marg>] ]<CR> 
where: 

<left marg> and < right marg> are positive integers. 
Restrictions on syntax: 

The <left marg> must be less than the <right marg>, and both must be between 1 and 
80, inclusive. 

Action: 

Sets the left and right margins in the workspace. (Margins are not defined in the monitor.) 
Default: 

If < right marg> is omitted, it is assumed to be 80. If < left marg> is omitted as well, it is 
assumed to be 1 . 

MONITOR 

Syntax: 

!MON[ITOR] [<number>] [ HtOST] ] [ KEYBOARD] ]<CR> 
Restrictions on syntax: 

The <number> parameter, if included, must be an integer in the range from 1 to 34, 
inclusive. 

Action: 

If the <number> parameter is included, this command erases both the workspace and 
the monitor. If <number> is less than 34, it then defines a workspace and reserves the 
top (34 - <number>) lines the screen for displaying that workspace. The bottom 
<number> lines of the screen are used to display the monitor. 
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If H (for Host) is specified, text coming from the host computer will be directed to the 
monitor. 

If K (for Keyboard) is specified, text coming from the keyboard will be directed to the 
monitor. 

Default: 

If no parameters are specified, and the MONITOR command comes over the communica- 
tions line from the host computer, it is executed as a MONITOR H command. If no 
parameters are specified and the command is typed on the keyboard, it is executed as a 
MONITOR K command. 



PARITY 

Syntax: 

!PAR[ITY] [ E[VEN] | 0[DD] | N[ONE] | D[ATA] ]<CR> 

Action: 

This command sets the terminal parity. If EVEN is specified, the 4025 transmits even 
parity and checks for even parity of incoming characters. ODD behaves similarly for odd 
parity. NONE indicates that parity is not checked on input; the parity bit is set to zero on 
output. DATA means that the parity bit is treated as data, and set to for output. 

Default: 

If the parameter is omitted, it is assumed to be N (for NONE). 

PROMPT 

Syntax: 



!PRO[MPT] [<string>]<CR> 



where <string> may be: 



(a) One or more delimited ASCII strings. A delimited ASCII string consists of a 
string of any printing ASCII characters (except the command character) with a 
delimiter at each end. The delimiter may be any printing character except the 
command character, space, comma, semi-colon, numerals, or letters of the 
alphabet. 
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(b) A sequence of ADE values (ASCII Decimal Equivalents) separated by spaces or 
commas. 

(c) Any combination of (a) or (b). 
Restrictions on syntax: 

The <string> parameter may not define a string of more than ten ASCII characters. 
Action: 

This command sets the prompt character or string. In buffered mode, the host must send 
a prompt before the 4025 will respond. 

Default: 

If <string> is omitted, the prompt string is set to the single character, "line feed." 

REPORT 

Syntax: 

!REP[ORT] <device><CR> 

where <device> is a two-digit number. 
Restrictions: 

For the <device> parameter, device numbers are as follows: 
Device Number Device 

00 System Status Block 

01 Alphanumeric Cursor 
02,03 Not Defined 

04-07 Tape Drives 1 -4 

08-11 Disc Drives 1-4 

12,13 Plotters 1,2 

14 Printer 
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Action: 

The status of the specified device is returned to the host. Besides the physical devices in 
the terminal system (such as the display or the tape unit) several logical entities (such as 
the cursor location in the workspace) may have their status interrogated. The returned 
status is in the following form: 

<command character> ANS <device> <parameter string> <semicolon> 

The format of the parameter string depends on the particular device reporting, as seen 
below. However, for a given device, the number, size, and type of each field is constant, 
therefore requiring no grammatical analysis by the host program. 

The report identifier, ANS (for ANSwer), is followed by one space, then by the two-digit 
device code. This field and subsequent fields are separated by commas; the last field is 
followed by a semicolon. 

Examples: 

(REPORT 00<CR> 

!ANS00,<p1>,<p2>; 

where: <p1 > 

is a 4-digit decimal number giving the number of unused blocks of memory. (A block 
consists of 16 8-bit bytes of memory.) 

<p2> 

is a 3-digit decimal number specifying the system status byte. Bit values in hexadecimal 
are: 

01 = Buffered 

02 = Form Fillout Mode 
04 = Monitor present 

!REP0KCR> 

!ANS 01, <p1 >,<p2>,<p3>; 

where: <p1 > 

is a 3-digit decimal number giving the row of the workspace in which the cursor is 
located. 
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<p2> 

is a 3-digit decimal number giving the column of the workspace in which the cursor is 
located. 

<p3> 
is a single character, denoting the character at the cursor position. 

If no workspace is defined, <p1 > AND <p2> are all zeroes, and <p3> is an ASCII 
"space" character. 



RDOWN (Roll Down) 

Syntax: 

!RDO[WN] [<count>]<CR> 
Action: 

This command rolls the current scroll (monitor or workspace) down <count> lines. The 
action stops when the top line of the scroll is visible on the screen. 

Default: 

If <count> is omitted, it is assumed to be one. 

RIGHT 

Syntax: 

!RIG[HT] [<count>]<CR> 
Action: 

This command causes the cursor to move <count> character positions to the right. If 
<count> would move the cursor beyond column 80, the cursor goes to the following line 
and continues moving until a total of <count> locations have been skipped over. Rollup 
may occur if the cursor was previously at the bottom of the part of the display list in view 
on the screen. 

Default: 

If <count> is omitted, it is assumed to be one. 
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RUP (Roll Up) 

Syntax: 

!RUP[<count>]<CR> 

Action: 

This command causes the current scroll (workspace or monitor) to roll up <count> lines. 
Action stops when the bottom of the current display list is in view on the screen. 

Default: 

If <count> is omitted, it is assumed to be one. 

RVECTOR (Relative Vector) 

(Requires Option 23, 24, 25, or 26.) 
Syntax: 

IRVEtCTOR] <rel x0>, <rel y0>, <rel x1 >, <rel y1 >, [<rel x2>, <rel 
y2> <rel xn>, <rel yn>]<CR> 



Examples of syntax: 



IRVECTOR 0,-1 0,1 0,0,0,1 0,-1 0,0<CR> 
!RVE 0,-1 0,1 0,0,0,1 0,-1 0,0<CR> 
!RVE 0,0,1 0,1 0<CR> 



Action: 



Draws relative vectors. The parameters for this command are x- and y-coordinates 
relative to the last vector beam position (the ending point of the last VECTOR or 
RVECTOR command). 
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!RVE 0, -1 0, 1 0, 1 0, -1 0, 1 0, -1 0, -1 < CR> 

Suppose that the last VECTOR or RVECTOR command left the beam at the graphic 
coordinates (100,100). This RVECTOR command moves the beam to the point 
(100+0, 100-10) = (100,90). From there, it draws a line segment to (100+10,90 + 10) = 
(1 1 0, 1 00). From there, it draws segments to (1 00,1 1 0) and (90,1 00), leaving the 
beam at (90,1 00). [A subsequent RVECTOR command would specify its coordinates 
relative to (90,1 00).] A string of coordinates may be continued to the next line by sending 
an ampersand "&", as the "last" character of the current line. (Valid for host commands 
only.) 

SEND 

Syntax: 



!SEN[D] [ A[LL] |M[OD] ]<CR> 



Action: 



SEND ALL. If not in form fillout mode, this command sends all data in the workspace to 
the host computer. Both the text in the workspace and any attribute codes are sent; the 
attribute codes are encoded as the corresponding ATTRIBUTE commands. 

If in form fillout mode, SEND ALL sends all unprotected data. If a field separator has not 
been defined (see the FIELD command), each unprotected field is sent in its entirety, 
including trailing spaces. If a field separator has been defined, trailing spaces are 
suppressed from each field and each field is preceded by a field separator. The last field 
is followed by a carriage return. 

SEND MOD. If not in form fillout mode, this command acts the same as SEND ALL: it 
sends the entire contents of the workspace to the host, encoding any field attribute codes 
as ATTRIBUTE commands. 

If in form fillout mode, SEND MOD sends all unprotected data which has been modified 
since the last SEND command and all protected fields with an attribute of M. Each field is 
preceded by two three-digit numbers, separated by a comma. These numbers specify the 
row of the workspace, and the character position within that row, where the field begins. 
For instance, if a modified field starts in Row 5, Column 3, when that field is sent to the 
computer it will be preceded by "005,003." The first character of the field immediately 
follows the last digit of the second three-digit number. Trailing blanks and separators are 
handled as described above for the SEND ALL command. 
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Default: 

If neither ALL nor MOD is specified, ALL is assumed. 

SHRINK 

(Requires Option 23, 24, 25, or 26.) 
Syntax: 

!SHR[INK] [ Y[ES] |H[ARDCOPY] | B[OTH] |N[0] ]<CR> 

Examples of syntax: 

!SHRINKYES<CR> 
!SHR Y<CR> 
!SHR<CR> 
!SHRB<CR> 

Action: 

SHRINK YES. This command causes the 4025 to "shrink" x- and y-coordinates in 
subsequent VECTOR or RVECTOR commands, multiplying them by a factor of approxi- 
mately 5/8. This accommodates the 4025 to the range of possible coordinates in 401 0- 
style graphics commands. 

In graphics commands for the TEKTRONIX 401 0-series terminals, the x-coordinates can 
be as great as 1 023, while the greatest possible x-coordinate in a 4025 VECTOR 
command is 639. (This would occur in a graphics area which occupied all 80 columns.) 
Since 5/8 of 1 024 is 640, the SHRINK command can accommodate the 4025 to display a 
401 0-style graphics command file. 

To use the 4025 to display a command file written for 401 0-series terminals, first 
dimension the graphics area to hold 35 rows of 80 columns. (!GRA 1 ,35,1 ,80 or !GRA 
1 0,44 are possible GRAPHIC commands to accomplish this.) Then give a SHRINK YES 
command to put the 4025 in "graphics shrink mode." 

SHRINK HARDCOPY. This command puts the 4025 in "hardcopy shrink mode." In this 
mode, the y-coordinates (but not the x-coordinates) in VECTOR and RVECTOR 
commands are reduced by a factor of 7/8. This pre-distorts graphs drawn on the 4025's 
screen, so they appear in the proper proportion when copied on a 4631 Hard Copy Unit. 
(However, character strings inserted in the graphics area with the STRING command will 
not be shrunk, as SHRINK HARDCOPY affects only the vectors and not the characters. 
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shrink" mode. The x-coordinates in subsequent VECTOR and RVECTOR commands are 
multiplied by approximately 5/8, while the y-coordinates are multiplied by approximately 
35/64. 

SHRINK NO. This command removes the 4025 from both shrink modes. 

Default: 

if no parameter is specified, YES is assumed. 

SHRINK NO is default at power up. 



SNOOPY 

Syntax: 

!SNO[OOPY] [ Y[ES] | N[0] ]<CR> 

Examples of syntax: 

!SNOOPY<CR> 
!SNO<CR> 
!SNOY<CR> 
!SNONO<CR> 

Action: 

SNOOPY YES places the 4025 in "snoopy mode," and SNOOPY NO removes it from that 
mode. In snoopy mode, the non-printing ASCII control characters are represented on the 
display by two-letter menmonics. (The "rubout" or "delete" character is represented by a 
"blotch" of fine diagonal lines.) 

Snoopy mode is useful for troubleshooting, as it allows the operator to examine all ASCII 
characters received on the communications line. It is also useful for inserting control 
characters into text stored in the workspace. (When the 4025 is not in snoopy mode, 
control characters typed into the workspace are not stored there, although cursor 
movement characters or the "bell" character may be immediately executed.) Commands 
are still executed in snoopy mode. 
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Restriction: 

To see the ASCII "null" character printed when examining incoming data, it is necessary 
to have "parity" set to "data." (See the PARITY command.) 

Default: 

If neither parameter is specified, YES is assumed. 

At power up, default is SNOOPY NO. 

STOPS 

Syntax: 

!STO[PS] [<stop 1 > L<stop n>...]<CR> 

Restrictions on syntax: 

No more than 1 6 parameters are allowed. 

Action: 

This command sets the tab stops. Stops are indicated by their column number from 2 to 
80 inclusive. All stops must be set at once and must be in ascending order. 

Default: 

If no parameters are specified, all stops are cleared. 

STRING 

(Requires Option 23, 24, 25 or 26.) 
Syntax: 

!STR[ING] <string> <CR> 
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(a) One or more delimited ASCII strings. A delimited ASCII string consists of a 
string of any printing ASCII characters (except the command character) with a 
delimiter at each end. The delimiter may be any printing character except the 
command character, space, comma, semicolon, numerals, or letters of the 
alphabet. 

(b) A sequence of ADE values (ASCII Decimal Equivalents) separated by spaces or 
commas. 

(c) Any combination of (a) or (b). 

Action: 

This command is used to put text in a graphic area. The text begins at the cell containing 
the current beam position. Any vectors or characters that were previously present in the 
character cells where the string is put are no longer visible, since each character of the 
string replaces the entire character cell in which it is placed. 

Example: 

!STR|ABC|<CR> 

Inserts the characters "ABC" in the graphic area. 

SYMBOL 

(Requires Option 23, 24, 25, or 26.) 

Syntax: 

!SYM[BOL] <symbol number> <font number> <value 1 > <value 
2>...<value 14><CR> 

where: 

<symbol number> is an integer from to 1 27, 

<font number> is an integer from 1 to 31 , 

< value n> is an integer from to 255. 
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Restrictions on syntax: 

The <font number> parameter must specify a character font for which graphics RAM 
(Random Access Memory) is installed. You can ascertain which character fonts have 
graphics RAM installed by running a GTEST command on the terminal. 

Action: 

Defines the dot matrix pattern by which a character (denoted > by < symbol number>) of 
the specified character font (<font number>) is to be displayed. Each symbol is 
displayed as a dot matrix with 1 4 rows of 8 dots each. < value n > is the decimal 
representation of the binary numeral whose individual bits specify the individual dots of 
row n in the dot matrix. 

Example: 

Suppose we are defining symbol 97 of character set 24 to represent a Greek letter alpha. 
We might have the following dot matrix: 

00000000 

00000000 (Here the letter X represents a dot 

00000000 which is turned on, and the numeral "0" 

00000000 (zero) represents a dot which is turned 

0X0 off: The fourteen rows of the matrix 

XX X may be represented by these binary 

0X0 Of numerals: 

0X00 X 000 00000000, 00000000, 00000000, 00000000, 

X X X 0000001 0, 001 1 01 00, 01 001 000, 01 001 000, 

0X0 001 1 01 00, 0000001 0, 00000000, 00000000, 

00000000 00000000, 00000000. 

00000000 The decimal representations of these 

00000000 numerals are 0,0,0,0,2,52,72,72,52,2,0, 

00000000 0,0,0. 



The SYMBOL command to set symbol number 97 of character font 24 to this matrix, then, 
is: 

!SYMBOL97,24,0,0,0,0,2,52,72,72,52,2,0,0,0,0<CR> 

Default: 

If fewer than 1 4 rows are specified, the last rows are assumed to be zeroes (i.e., have all 
their dots turned off). 
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SYSTAT 

Syntax: 

!SYS[TAT]<CR> 
Action: 

This command causes the 4025 to display in its monitor a list of system parameters. 
Parameter names are abbreviated in the display as follows: 

TB - transmit baud rate 

RB - receive baud rate 

DL - delay time 

LM - left margin 

RM - right margin 

WL - number of workspace lines displayed on the screen 

V# - firmware version number 

TS - tab stops 

CC - command character 

FS - field separator 

PR - prompt string 

EL - end-of-line string 

DU - duplex ("DU = F" means full duplex, "DU = H" means half duplex.) 

EC - echo ("EC=R" means remote echo, "EC = L" means local echo.) 

BU - buffered mode ("Y" for buffered, "N" for unbuffered.) 

FF - form fillout mode ("Y" for yes, "N" for no.) 

SN - snoopy mode ("Y" for yes, "N" for no.) 

KB - keyboard ("KB=M" means text typed on the keyboard is directed to the monitor, 

"KB=W" means text from the keyboard is sent to the workspace.) 

CM - communications line ("CM = M" means text from the communications line is 

directed to the monitor, "CM=W" means such text is sent to the workspace.) 

PA - parity ("N" for "none," "D" for "data," "E" for "even," "O" for "odd.") 

Additional SYSTAT parameters: 

If Option 1 (Half Duplex) is installed and the 4025 is set for half duplex, the DU field may 
contain one or two additional letters. See the DUPLEX command description for details. 

If Option 10 (Polling Interface) is installed, then an additional field, "PL=", will appear, 
followed by a two-digit decimal number indicating the receiving address of this display 
station. 
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When the 4025 is turned off or reset, it remembers some of the parameter settings listed 
in the SYSTAT message, and resets others to default settings. Those settings which are 
remembered are: TB, RB, DL, LM, RM, TS, CC, FS, PR, EL, DU, EC, and PA. (And the PL 
setting, if present.) 

When the 4025 is powered up or reset, it will always be the case that: 

(a) WL = (there is no workspace defined) 

(b) BU = N (the 4025 is in unbuffered mode) 

(c) FF = N (the 4025 is not in form fillout mode) 

(d) SN = N (the 4025 is not in snoopy mode) 

(e) KB = M and CM = M (text from both the keyboard and the computer is directed 
into the monitor) 

The V# setting will not change unless a different firmware version is installed in the 
4025. 



TAB 

Syntax: 

!TAB[<count>]<CR> 

Action: 

This command performs the same action as <count> tab characters. For each tab, the 
cursor is moved to the next tab stop (if not in form fillout mode) or to the beginning of the 
next unprotected field (in form fillout mode). A tab may also be performed by sending the 
ASCII tab character. 

Default: 

If <count> is omitted, it is assumed to be one. 
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TEST 

Syntax: 

!TES[T]<CR> 
Action: 

1. System ROM (Read Only Memory), system RAM (Random Access Memory), and display 
RAM are checked. The four system ROM checksums are displayed. An error in display 
RAM will cause the bad block of memory not to be used. The number of free blocks will 
therefore be reduced, but the terminal will run correctly. 

2. After the memory test, the lights on the four lighted function keys are turned on, all 1 28 
ASCII characters are printed in snoopy mode, and font 1 (the ruling set) is displayed. (If 
this character set is not installed, each of its characters will be displayed as a dot 
matrix with every dot turned on.) 

After the two character sets, the seven visual attributes are presented. 

3. At the end of the test, the lights on the function keys are turned off and the bell is rung. 

Should the test reveal a failure in the system RAM, the message "RAM 
ERROR" will appear. In that case, service personnel should be called. 

NOTE 

Running this test destroys any text or key definitions which may have been 
stored in the 4025's memory. 

UP 

Syntax: 

!UP[<count>]<CR> 

Action: 

This command moves the cursor up <count> lines. If <count> is great enough to move 
the cursor off the visible part of the workspace or monitor scroll, that scroll will be rolled 
down to keep the cursor in view. Action stops when the cursor reaches the top line in the 
display list. 
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Default: 

If <count> is omitted, it is assumed to be one. 

VECTOR 

(Requires Option 23, 24, 25 or 26.) 

Syntax: 

!VEC[TOR] <xo> <yo> <x1 > <y1 > [<x2> <y2> ... <xn> <yn>]<CR> 

Action: 

This command draws vectors (line segments) in the graphics area of the workspace. The 
parameters <xo>,<yo> specify the x- and y-coordinates of the starting point for the 
first line segment; <x1 >,<y1 > specify that segment's end point. If a third pair of 
coordinates <x2>,<y2> are specified, then a second segment will be drawn starting at 
the end of the first segment and continuing to the point specified by <x2>,<y2>. 
Additional pairs of coordinates cause additional line segments to be drawn in a like 
manner. 

The x- and y-coordinates refer to the position of each point in the dot matrix which 
comprises the graphic area. (In order for the VECTOR command to operate, such a 
graphic area must previously have been defined with a GRAPHIC command.) Each cell of 
the graphic area is an 8 x 1 4 dot matrix. Consequently, if the graphic area includes ten 
rows of cells, each with 1 4 rows of dots, it will have 1 40 rows of dots, numbered in y- 
coordinate from to 1 39. (Y-coordinate zero specifies the bottom row, and y-coordinate 
1 39 the top row.) If the graphics area is 50 cells wide, it will likewise have 400 columns of 
dots, numbered in x-coordinate from to 399. 

Each pair of coordinates in a VECTOR command must specify a point within the graphic 
area; otherwise the line segments to that point will not be drawn. 
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VRULE (Vertical Rule) 

(Requires Option 32.) 

Syntax: 

!VRU[LE] <row> <column> [ <length> [<width>] ]<CR> 

Restrictions on syntax: 

All parameters are positive integers. The < column > parameter must not exceed 80, and 
the <width> parameter, if specified, must be either 1 or 2. 

Action: 

Draws a vertical ruling in the workspace. The first ruling character is inserted at the row 
and column specified by the <row> and <column> parameters, and the ruling 
continues downward for a total of < length > character cells. The ruling is a single line if 
< width > is one, and a double line if < width > is two. 

Default: 

If < length > or < width > are omitted, they are assumed to be one. 

WORKSPACE 

Syntax: 

WORKSPACE] [<number>] [ H[OST] ] [ KEYBOARD] ]<CR> 

Restriction on syntax: 

The <number> parameter, if specified, must be an integer in the range from to 33. This 
always leaves at least one line for the monitor. 

Action: 

If the <number> parameter is included, this command erases both the workspace (if one 
is defined) and the monitor. It then defines a workspace, and allots the top <number> 
lines of the screen for displaying that workspace. The remaining lines below are used to 
display the monitor. 
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If H (for Host) is specified, text from the host computer will be directed to the workspace. 

If K (for Keyboard) is specified, text from the keyboard will be directed to the workspace. 
(However, commands to the 4025 which are typed on the keyboard will still be displayed 
in the monitor.) 

Default: 

If no parameters are specified, and the command comes over the communications line 
from the host computer, it will be executed as a WORKSPACE H command. If no 
parameters are specified and the command is typed on the keyboard, it is executed as a 
WORKSPACE K command. 

If <number> is the only parameter specified, then a workspace is defined, but the 
direction of text from the keyboard and the host is not changed. However, a WORKSPACE 
command directs text from both the keyboard and the host to the monitor (since no 
workspace is defined). 



PROGRAMMING THE COMPUTER TO CONTROL THE 4025 

The person who programs a computer to control the 4025 may use almost any 
programming language. The only requirement is that the language have an instruction to 
display literal information. Common examples are the WRITE statement in FORTRAN, the 
PRINT statement in BASIC, or the DISPLAY statement in COBOL. 

Commands to the 4025 are sent as literal information in a programming language 
instruction, as though the command were to be displayed on the 4025 screen. When the 
4025 sees the command character, however, it assumes a command follows, and looks 
for one. When it recognizes a command, it executes that command instead of displaying it. 
The command character is the vital ingredient. For example, the BASIC statement: 

100 PRINT "IWOR 20 K" 

will create a workspace of 20 lines, and direct text from the keyboard into the workspace. 
However, the BASIC statement: 

200 PRINT "WOR 20 K" 

will cause the text: 

WOR 20 K 
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character "!" in line 1 00. In that line, "!" identifies the text: 

WOR 20 K 

as a command to be executed. In line 200, there is no command character, and: 

WOR 20 K 

is treated simply as text to be displayed on the screen. 

Examples: 

The BASIC instruction: 

1 00 PRINT "!WOR 20 K;!STOPS 5,1 0,20,60;!BUF YES;" 

creates a workspace of 20 lines, directs text from the keyboard into the workspace; 
creates tab stops at columns 5, 1 0, 20 and 60; and places the 4025 in buffered mode. 

In our sample COBOL program (Appendix C), when TFFO-7 is displayed (lines 01 8600- 
01 8700) the following string of characters is received by the 4025: 

!JUM7;!ATTPS; OUR ACCTIATT AE; !ATT PS; 

This string of characters causes the following events occur: 

The cursor moves to the beginning of line 7 and defines a protected field 
with standard visual attributes. 

The text " OUR ACCT" is placed in that field. 

A new field is begun at the character position after the "T" in "ACCT," with 
attributes of alphanumeric, enhanced. 

Several spaces are entered in that field. 

Finally, the rest of that line is defined as a field with the attributes of 
protected, standard. 
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Invalid Commands 

If the 4025 receives an invalid command, the results depend on the origin of the invalid 
command. In the following examples suppose the command keyword "STOPS" is 
misspelled "STEPS". 

If the invalid command: 

ISTEPS 20,40,60; <CR> 

is given from the keyboard, an error message is printed and the invalid command 
repeated: 

WHAT? 

ISTEPS 20,40,60; 

Suppose this same invalid command is sent from the host in the following BASIC 
statement: 

1 00 PRINT "ISTEPS 20,40,60;" 
The invalid command: 

ISTEPS 20,40,60 
will be treated as text and printed in whichever scroll prints text from the host. 

Suppose this same invalid command is part of a string of commands. If the command 
string comes from the keyboard, commands which precede the invalid command will be 
executed. The rest of the line will be printed, with an error message. 

For example, if the command string: 

ERA W;!STEPS 20,40,60; IBEL; <CR> 

is entered from the 4025 keyboard, the following events occur: 

(a) The workspace is erased; and 

(b) WHAT? 

ISTEPS 20,40,60;!BEL; 

is printed in the monitor. 
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1 00 PRINT "ERA W;!STEPS 20,40,60;!BEL;" 
then the following events occur: 

(a) The workspace is erased; 

(b) The text 
ISTEPS 20,40,60; 

is printed in whichever scroll prints text from the host; and 

(c) The terminal's bell rings. 

Note also that if the 4025 receives a command that requires a workspace, when no 
workspace is defined, that command string will simply cease to be. Nothing will be 
executed, and no error message will appear. 

How, then, does one display commands on the 4025 screen in order to read, debug, or 
modify an existing program? The 4025 operator must place the 4025 in COMMAND 
LOCKOUT mode by pressing the COMMAND LOCKOUT key. This prevents the 4025 from 
executing any commands. Instead, all information that the 4025 receives from the 
computer is treated as text, and all printed characters are displayed on the screen. This 
may be used with SNOOPY mode to examine all information received, both printed and 
non-printed characters, since in SNOOPY mode each non-printed ASCII character is 
assigned a printed two-letter mnemonic. Note that the SNOOPY YES command may be 
given from the computer, but the COMMAND LOCKOUT mode cannot be entered or left by 
computer command. Thus it will be the 4025 operator who sets up the 4025 to read, 
modify and debug programs containing 4025 commands. 

See Appendix C for a sample program in COBOL using the form fillout features of the 
4025. 
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OPTIONAL CHARACTER SETS 

With the proper options, the 4025 can accommodate up to 32 different fonts, each 
containing up to 1 28 characters. Thirty of these fonts may be user-defined. The standard 
font is Font 0. and rannnt hp mnrlifiprl hu tho Anoc, morainr /-.r kw th« k«„» i~ «^-i:»; *_ 

the standard font, tWo other pre-defined fonts are available: Math Characters (Option 34) 
and Rulings Characters (Option 32). (See the following discussion of rulings for details on 
this font.) Fonts other than the standard font are selected using the ATTRIBUTE 
command. 

The SYMBOL command is used to define alternate fonts, one symbol at a time. The 
DFONT (Delete Font) command deletes a user-defined font that is no longer needed. 
User-definable fonts that are not currently programmed with alternate character sets can 
be used to store and recall graphic information. 

See Section 2, "Command Descriptions" for proper use of these commands. 



Rulings 

Option 32 for the 4025 provides a set of rulings characters. Rulings provide a way of 
visually outlining the structure of a form. A ruling line is either a single or double line, 
either horizontal or vertical, and occupies a row or column of character cells. 

There are two ways to create rulings: 

1 . Use the HRULE and VRULE commands; or 

2. Use the ATTRIBUTE command to select Font 1 (which is always the rulings font 
on the 4025), and select the appropriate ruling characters from Font 1 . (See 
Appendix A, Table 1 .) 
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When drawing rulings on the 4025 display using the HRULE and VRULE commands, 
vertical and horizontal rulings generally will not meet properly. There will be gaps or 
unwanted crossings. The variety of ruling characters provided in Option 32 allows the 
operator or programmer to make neat, well-fitted junctions by selecting the appropriate 
characters. Appendix A, Table 1, shows the correspondence between ASCII Decimal 
Equivalents (ADE), Font characters, and Font 1 characters. Appendix A, Table 2, 
provides a graphic reference sheet for making the proper junctions. A detailed example is 
found in the 4025 Operator's Manual. 



NOTE 

Referring to Table 2, Appendix A, note, for example, that both the ASCII 
"NULL" (ADE 000) and the ASCII " @" (ADE 064) give the same ruling 
character in Font 1. The same holds throughout the table; two different 
ASCII characters will generate the same ruling character. It is strongly 
recommended that the operator or programmer use the ASCII characters 
with ADE's 064-126 to generate ruling characters in Font 1. Problems may 
arise when ADE's 000-063, and 127 are used, depending on the internal 
configuration of the particular terminal. 



OPTIONAL INTERFACES 

Several optional interfaces are available for the 4025. These make possible many useful 
system configurations using the 4025. 

Current Loop Interface (Option 2) - This allows the 4025 to operate on a 20 mA current 
loop. 

Polling Interface (Option 10) - This option allows the 4025 to operate as a polling display 
station in an IBM 3270 multidrop environment. 

Polling Controller (Option 1 1) - This option converts the 4025 into a polling controller for 
up to eight 4025 display stations in an IBM 3270 environment. The Option 1 1 plugs into 
one of the 4025 display stations and controls all the 4025's in the group, including the 
4025 in which it resides. 

Half Duplex (Option 1)- When the half duplex option is installed, the DUPLEX command is 
added to the terminal command set. 
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mo-*j* Peripheral inierface (Option 3) - This interface allows the 4025 to communicate 
with a 4662 Plotter and a 4642 Printer, and direct data from the host to one of these 
devices. (See Hard Copy Section below.) 

GPIB Peripheral Interface (Option 4)- In addition to routing data between the host and the 
various peripherals, the terminal will be able to perform some operations involving 
interaction between the terminal itself and various peripherals. These include: 

Creating command files on tape and then using them to drive the terminal. 

Transferring files from one mass storage device to another. 

Spooling pictures onto mass storage and then routing them to the display 
or plotter. 



HARD COPIES 

The 4025 Computer Display Terminal is compatible with 4631 Hard Copy Unit and 4642 
Printer operations. 

To make copies on the 4631 Hard Copy Unit, the 4025 must have Option 40 (Hard Copy 
and Video Out) installed. The 4631 Hard Copy Unit can copy whatever is in the 
workspace, in the monitor, or on the 4025 screen, including alternate font characters, 
rulings, and graphic display. Copies on the 4631 are made using the HCOPY command. 
Note that the 4631 copies 53 lines of text, which is more than the 4025 screen is able to 
display at one time. Text in the 4025 display memory need not be displayed on the screen 
to be copied. The 4631 copies are approximately 8-1 12" x 1 1 ". 

To make copies on the 4642 Printer, the 4025 must have Option 3 (RS-232 Peripheral 
Interface) installed. The 4642 Printer will make printed copies of data from either the 
4025 workspace or from the host. The COPY command is used to do this. The 4642 
cannot print graphics, however, and all rulings characters are replaced with asterisks. A 
further note of caution is needed. The 4025 will continue to copy data from the host 
computer onto the 4642 until one of three things happens: (1 ) The computer sends an 
"end-of-file" string, telling the 4025 to stop copying; (2) The 4025, in buffered mode, 
receives a prompt string from the host; or (3) The operator types on the 4025 keyboard 
with the 4025 in unbuffered mode. 
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GRAPHICS 

If the 4025 has a Graphics Memory Option (Option 23, 24, 25 or 26), the operator or 
programmer can create a graphics area in which a variety of vector types can be drawn. 

To set up a graphics area in the workspace, use the GRAPHIC command. To draw vectors 
in the graphics area, use the VECTOR and RVECTOR commands. To specify the type of 
vector to be drawn, use the LINE command, and to erase the vectors in the graphics area, 
use the ERASE G command. See Section 2, "Command Descriptions" for a complete 
discussion of these commands. 



4010-Style Graphics 

The 4025 with a Graphics Memory Option, will accept 4010-style graphic commands 
when these commands are sent from the host. (The 4025 will not accept 401 0-style 
graphics commands entered from its keyboard.) The 4010-style graphics are character- 
ized by addressable screen coordinates and the use of ASCII characters which encode 
these addresses. 

To enable the 4025 to respond properly to 401 0-style graphic commands, type: 

!GRAPHIC1,35 <CR> 
ISHRINK <CR> 

This sets up a graphics area which is the right shape for holding a 401 0-style graphics 
display. In particular, the graphics area is approximately 1024X by 780Y, in terms of 
screen coordinates. 

The commands that the 4025 will accept from the host are as follows: 

1 . The GS command places the 4025 in 401 0-style graph mode. 

2. The US command exits the 4025 from graph mode, and positions the cursor at the 
character cell nearest the final beam position in graph mode. 

3. The ESC command causes the 4025 to exit 401 0-emulation in order to handle escape 
sequences. 

4. The ESC-Form Feed command exits the 4025 from graph mode, erases the display, and 
moves the cursor to the home position. 
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Addressing the Display Beam 

The beam is addressed to a point in the graphics area by sending to the terminal the 
binary equivalents of the Y address and the X address of the point. Each binary 
equivalent must be separated into two bytes: the 5 most significant bits and the 5 least 
significant bits. For example, 205Y.1 48X translates to 001 1 001 101 Y.001 001 01 00X 
(binary). The 001 1 001 1 01 Y becomes 001 1 HiY and 01 1 01 LoY; the 001 001 01 00 
becomes 001 00 HiX and 1 01 00 LoX. If these bytes are sent to the terminal in the GS 
mode, the beam will move to the 205Y.148X position in the graphics area. These bytes 
are encoded as ASCII equivalents. See the Coordinate Conversion Chart in Appendix A. In 
this example, 205Y.1 48X would be addressed in GS mode as "&M$T." 

Graph Mode Memory 

When an address is sent to the terminal, the HiY, LoY and HiX bytes are stored in a 
register. Therefore, if the next address sent to the terminal repeats some of these bytes, 
they need not be reentered from the terminal. (The LoX must always be sent, since it 
activates the move or draw.) Even if the 4025 leaves graph mode and reenters it later, 
these three bytes are retained. The following table shows which bytes must be sent in 
response to specific byte changes. 



HiX Lo X 

* 
# 



Graphics Creation 

After receiving the GS command, the 4025 waits for the 401 0-style codes. If the GS 
command is followed by BEL (ADE 7) the first LoX causes a draw. If no BEL is received, 
the first LoX causes a move (dark vector). HiX/Y's are taken to be HiY until a LoY is 
found, after which they are taken to be HiX's. Subsequent LoY's replace the old LoY (as 
on the 401 0) so the extra bits are ignored. LoX's cause the next vector to be drawn. The 
last coordinates in 401 0-mode are remembered until the next time GS mode is entered. 
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Thus a US command can appear, followed by a GS command with fewer than 4 
coordinate characters. Control characters between a GS command and the next US 
command are swallowed, except for ESCAPE and ESCAPE-Form Feed, as noted 
previously. 

When 401 0-mode is exited, the communications port is returned to the portion of display 
memory it was in before entering graph mode (workspace or monitor). 
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Table A- 1 

ALTERNATE CHARACTER FONTS FOR THE 4025 
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Table A-2 
RULING JUNCTIONS 
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Table B-1 
COORDINATE CONVERSION CHART 
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] 


93 


29 


61 


93 


125 


157 


189 


221 


253 


125 


} 


A 


94 


30 


62 


94 


126 


158 


190 


220 


254 


126 


~ 


— 


95 


31 


63 


95 


127 


159 


191 


223 


255 


127 


R ttnar 




32 


33 


34 


35 


36 


37 


38 


39 






UfcL.. 










SP 


! 


" 


# 


$ 


% 


& 










* 














High Order X& Y 













Coordinate conversion chart, part 1 of 4. INSTRUCTIONS: Find coordinate value in body of chart; follow that column to bottom of chart to 
find decimal value or ASCII character which represents the High Y or High X byte; go to the right in the row containing the coordinate value to 
find the Low Y byte, or go to the left to find the Low X byte. EXAMPLE: 200Y, 48X equals 38 104 33 80 in decimal code, and equals & h ! P 
in ASCII code. 
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Table B-1 (cont.) 
COORDINATE CONVERSION CHART 



Low Order X 


















Low Order Y 


ASCII 


DEC. 








X or Y Coordinate 








DEC. 


ASCII 


@> 


64 


256 


288 


320 


352 


384 


416 


448 


480 


96 


■ 


A 


65 


257 


289 


321 


353 


385 


417 


449 


481 


97 


a 


B 


66 


258 


290 


322 


354 


386 


418 


450 


482 


98 


b 


C 


67 


259 


291 


323 


355 


387 


419 


451 


483 


99 


c 


D 


68 


260 


292 


324 


356 


388 


420 


452 


484 


100 


d 


E 


69 


261 


293 


325 


357 


389 


421 


453 


485 


101 


e 


F 


70 


262 


294 


326 


358 


390 


422 


454 


486 


102 


f 


G 


71 


263 


295 


327 


359 


391 


423 


455 


487 


103 


g 


H 


72 


264 


296 


328 


360 


392 


424 


456 


488 


104 


h 


I 


73 


265 


297 


329 


361 


393 


425 


457 


489 


105 


i 


J 


74 


266 


298 


330 


362 


394 


426 


458 


490 


106 


i 


K 


75 


267 


299 


331 


363 


395 


427 


459 


491 


107 


k 


L 


76 


268 


300 


332 


364 


396 


428 


460 


492 


108 


I 


M 


77 


269 


301 


333 


365 


397 


429 


461 


493 


109 


m 


N 


78 


270 


302 


334 


366 


398 


430 


462 


494 


110 


n 





79 


271 


303 


335 


367 


399 


431 


463 


495 


111 





P 


80 


272 


304 


336 


368 


400 


432 


464 


496 


112 


P 


Q 


81 


273 


305 


337 


369 


401 


433 


465 


497 


113 


q 


R 


82 


274 


306 


338 


370 


402 


434 


466 


498 


114 


r 


S 


83 


275 


307 


339 


371 


403 


435 


467 


499 


115 


s 


T 


84 


276 


308 


340 


372 


404 


436 


468 


500 


116 


t 


U 


85 


277 


309 


341 


373 


405 


437 


469 


501 


117 


u 


V 


86 


278 


310 


342 


374 


406 


438 


470 


502 


118 


V 


w 


87 


279 


311 


343 


375 


407 


439 


471 


503 


119 


w 


X 


88 


280 


312 


344 


376 


408 


440 


472 


504 


120 


X 


Y 


89 


281 


313 


345 


377 


409 


441 


473 


505 


121 


y 


z 


90 


282 


314 


346 


378 


410 


442 


474 


506 


122 


z 


[ 


91 


283 


315 


347 


379 


411 


443 


475 


507 


123 


{ 


\ 


92 


284 


316 


348 


380 


412 


444 


476 


508 


124 


' 


] 


93 


285 


317 


349 


381 


413 


445 


477 


509 


125 


} 


A 


94 


286 


318 


350 


382 


414 


446 


478 


510 


126 


~ 




95 


287 


319 


351 


383 


415 


447 


479 


511 


127 


R «f^V T 


r\rr* 


40 

I 


41 

) 


42 

* 


43 

+ 


44 


45 


46 


47 
/ 






Utt. 

AC*P I I 








MoL 1 1 
















HighOrderX&Y 













Coordinate conversion chart, part 2 of 4. (Refer to part 1 for interpretation instructions.) 
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COORDINATE CONVERSION CHART 



APPENDIX B 



Low Order X 


















Low Order Y 


ASCII 


DEC. 








X or Y Coordinate 








ASCII 


DEC. 


@ 


64 


512 


544 


576 


608 


640 


672 


704 


736 


i 


96 


A 


65 


513 


•545 


577 


609 


641 


673 


705 


737 


a 


97 


B 


66 


514 


546 


578 


610 


642 


674 


706 


738 


b 


98 


C 


67 


515 


547 


579 


611 


643 


675 


707 


739 


c 


99 


D 


68 


516 


548 


580 


612 


644 


676 


708 


740 


d 


100 


E 


69 


517 


649 


581 


613 


645 


677 


709 


741 


e 


101 


F 


70 


518 


550 


582 


614 


646 


678 


710 


742 


f 


102 


G 


71 


519 


551 


583 


615 


647 


679 


711 


743 


9 


103 


H 


72 


520 


552 


584 


616 


648 


680 


712 


744 


h 


104 


I 


73 


521 


553 


585 


617 


649 


681 


713 


745 


i 


105 


J 


74 


522 


554 


586 


618 


650 


682 


714 


746 


i 


106 


K 


75 


523 


555 


587 


619 


651 


683 


715 


747 


k 


107 


L 


76 


524 


556 


588 


620 


652 


684 


716 


748 


I 


108 


M 


77 


525 


557 


589 


621 


653 


685 


717 


749 


m 


109 


N 


78 


526 


558 


590 


622 


654 


686 


718 


750 


n 


110 





79 


527 


559 


591 


623 


655 


687 


719 


751 





111 


P 


80 


528 


560 


592 


624 


656 


688 


720 


752 


P 


112 


Q 


81 


529 


561 


593 


625 


657 


689 


721 


753 


q 


113 


R 


82 


530 


562 


594 


626 


658 


690 


722 


754 


r 


114 


S 


83 


531 


563 


595 


627 


659 


691 


723 


755 


5 


115 


T 


84 


532 


564 


596 


628 


660 


692 


724 


756 


t 


116 


U 


85 


533 


565 


597 


629 


661 


693 


725 


757 


U 


117 


V 


86 


534 


566 


598 


630 


662 


694 


726 


758 


V 


118 


w 


87 


535 


567 


599 


631 


663 


695 


727 


759 


w 


119 


X 


88 


536 


568 


600 


632 


664 


696 


728 


760 


X 


120 


Y 


89 


537 


569 


601 


633 


665 


697 


729 


761 


y 


121 


z 


90 


538 


570 


602 


634 


666 


698 


730 


762 


z 


122 


[ 


91 


539 


571 


603 


635 


667 


699 


731 


763 


{ 


123 


\ 


92 


540 


572 


604 


636 


668 


700 


732 


764 


; 


124 


] 


93 


541 


573 


605 


637 


669 


701 


733 


765 


} 


125 


A 


94 


542 


574 


606 


638 


670 


702 


734 


766 


~ 


126 


— 


95 


543 


575 


607 


639 


671 


703 


735 


767 


r Vd b .?lV t 


127 


nrp 


48 


49 


50 


51 


52 


53 


54 


55 












ASCII — 







1 


2 


3 


4 


5 


6 


7 
















High Order X& Y 













Coordinate conversion chart, part 3 of 4. (Refer to part 1 for interpretation instructions.) 
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Table B-1 (cont.) 
COORDINATE CONVERSION CHART 



Low Order X 


















Low Order Y 


ASCII 


DEC. 








X or Y Coordinate 








DEC. 


ASCII 


@ 


64 


768 


800 


832 


864 


896 


928 


960 


992 


96 


\ 


A 


65 


769 


801 


833 


865 


897 


929 


961 


993 


97 


a 


B 


66 


770 


P02 


834 


866 


898 


930 


962 


994 


98 


b 


C 


67 


771 


803 


835 


867 


899 


931 


963 


995 


99 


c 


D 


68 


772 


804 


836 


868 


900 


932 


964 


996 


100 


d 


E 


69 


773 


805 


837 


869 


901 


933 


965 


997 


101 


e 


F 


70 


774 


806 


838 


870 


902 


934 


966 


998 


102 


f 


G 


71 


775 


807 


839 


871 


903 


935 


967 


999 


103 


g 


H 


72 


776 


808 


840 


872 


904 


936 


968 


1000 


104 


h 


I 


73 


777 


809 


841 


873 


905 


937 


969 


1001 


105 


i 


J 


74 


778 


810 


842 


874 


906 


938 


970 


1002 


106 


i 


K 


75 


779 


811 


843 


875 


907 


939 


971 


1003 


107 


k 


L 


76 


780 


812 


844 


876 


908 


940 


972 


1004 


108 


I 


M 


77 


781 


813 


845 


877 


909 


941 


973 


1005 


109 


m 


N 


78 


782 


814 


846 


878 


910 


942 


974 


1006 


110 


n 





79 


783 


815 


847 


879 


911 


943 


975 


1007 


111 





P 


80 


784 


816 


848 


880 


912 


944 


976 


1008 


112 


P 


Q 


81 


785 


817 


849 


881 


913 


945 


977 


1009 


113 


q 


R 


82 


786 


818 


850 


882 


914 


946 


978 


1010 


114 


r 


s 


83 


787 


819 


851 


883 


915 


947 


979 


1011 


115 


s 


T 


84 


788 


820 


852 


884 


916 


948 


980 


1012 


116 


t 


u 


85 


789 


821 


853 


885 


917 


949 


981 


1013 


117 


u 


V 


86 


790 


822 


854 


886 


918 


950 


982 


1014 


118 


V 


W 


87 


791 


823 


855 


887 


919 


951 


983 


1015 


119 


w 


X 


88 


792 


824 


856 


888 


920 


952 


984 


1016 


120 


X 


Y 


89 


793 


825 


857 


889 


921 


953 


985 


1017 


121 


V 


z' 


90 


794 


826 


858 


890 


922 


954 


986 


1018 


122 


z 


[ 


91 


795 


827 


859 


891 


923 


955 


987 


1019 


123 


{ 


\ 


92 


796 


828 


860 


892 


924 


956 


988 


1020 


124 


' 


] 


93 


797 


829 


861 


893 


825 


957 


989 


1021 


125 


) 


A 


94 


798 


830 


862 


894 


926 


958 


990 


1022 


126 


R HSffiT 




95 


799 


831 


863 


895 


927 


959 


991 


1023 


127 


npr 


56 


57 


58 


59 


60 


61 


62 


63 










3 


g 






< 


= 


> 


? 






AoU II- 








HighOrd 
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Coordinate conversion chart, part 4 of 4. (Refer to part 1 for interpretation instructions.] 



B-4 



@ 



4025 PROGRAMMER'S REFERENCE 



APPENDIX B 



Table B- 2 
ASCII CODE CHART 



B 
1 


T 


BT 
B6 
BS 







w 


1 




i 





i 
1 


1 





1 



1 


1 

1 




1 

■ 

1 


S 

M « B2 „ 


CONTROL 


HIGH X & Y 
GRAPHIC INPUT 


LOWX 


LOWY 














NUL 


1« 
DLE 


32 

SP 


48 




84 


8* 

P 


98 
\ 


112 
P 











1 


1 
SOH 


17 

DC1 


33 
1 


49 

1 


85 

A 


81 

Q 


97 

a 


113 

q 








1 





2 

STX 


it 
DC2 


34 

n 


SO 

2 


88 

B 


82 

R 


98 

b 


114 

r 








1 


1 


3 

ETX 


19 

DC3 


35 

# 


51 

3 


87 

c 


63 

s 


99 

c 


115 

s 





1 








EOT 


DC4 


36 

$ 


52 

4 


68 

D 


84 

T 


1#* 
d 


116 
t 





1 





1 


s 

ENQ 


21 

NAK 


37 
% 


53 

5 


69 

E 


85 

u 


191 

e 


117 

u 





1 


1 





ACK 


22 

SYN 


38 

& 


54 

6 


7* 

F 


86 

V 


1*2 
f 


116 

V 





1 


1 


1 


7 

BEL 

BELL 


23 

ETB 


39 
/ 


55 

7 


71 

G 


67 

w 


193 

9 


119 

w 


1 











S 

BS 

BACKSPACE 


24 

CAN 


40 
( 


58 

8 


72 

H 


88 

X 


194 

h 


12* 

X 


1 








1 


• 

HT 


25 

EM 


41 
) 


57 

9 


73 
I 


89 

Y 


1*5 

i 


121 

y 


1 





1 





i* 
LF 


26 

SUB 


42 
* 


58 


74 
J 


99 

z 


1*6 
J 


122 

z 


1 





1 


1 


11 
VT 


27 

ESC 


43 

+ 


59 
1 


75 

K 


91 
[ 


1*7 

k 


123 
{ 


1 


1 








12 

FF 


2« 

FS 


44 

) 


60 
< 


76 

L 


92 
\ 


1*8 
1 


124 

1 
I 


1 


1 





1 


13 

CR 

RETURN 


29 

GS 


45 


61 


77 

M 


93 
] 


1*9 

m 


125 
} 


1 


1 


1 





14 

SO 


RS 


46 


62 
> 


78 

N 


94 

A 


11* 
n 


126 


1 


1 


1 


1 


IS 

SI 


31 

US 


47 
/ 


63 
? 


79 




95 


in 




127 

RUBOUT 
(DEL) 
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SAMPLE COBOL PROGRAM 



000100 

000020 

000300 

000400* 

000500** 

000600** 

000700** 

000800** 

000900 

001000** 

001100** 

001200** 

001300** 

001400** 

001500** 

001600** 

001700** 

001800** 

001900** 

002000** 

002100** 

002200** 

002300** 

002400** 

002500** 

002600** 

002700** 

002800** 

002900** 

005200 

005300 

005400 

005500 

005600 

005700 

005800 

005900 



IDENTIFICATION DIVISION. 
PROGRAM-ID. FORM. 
REMARKS. 

THIS IS A SAMPLE PROGRAM WHICH SENDS A FORM 
TO THE 4025 AND PROCESSES THE DATA RETURNED. 

<< INPUT/OUTPUT ASSUMPTIONS >> 

THIS PROGRAM USES THE 'ACCEPT' AND 'DISPLAY' VERBS TO 
COMMUNICATE WITH THE 4025 VIDEO TERMINAL. FILE OUTPUT 
IS AS PER USUAL. 

THE INPUT FROM THE 4025 IS VARIABLE IN LENGTH WITH 
THE FIRST 7 CHARACTERS ALWAYS PRESENT AND IN THE 
SAME FORMAT. 



FROM 4025: ROW,COL DATA . 



I 

!_END OF DATA 

START OF DATA 

-.COLUMN DATA STARTS IN 
ROW DATA STARTS IN 



THIS PROGRAM WAS ORIGINALLY DEVELOPED ON A 
DECSYSTEM-1 AND WITH MODIFICATIONS TO THE 'SELECT 
AND 'FD' STATEMENTS AND CHANGING THE 'DISPLAY-7' TO 
WHATEVER DISPLAY ALLOWS INPUT OF UPPER AND LOWER CASE 
CHARACTERS SHOULD CONVERT IT TO ANOTHER SYSTEM. 
ENVIRONMENT DIVISION. 
INPUT-OUTPUT SECTION. 
FILE-CONTROL 

SELECT TEK-FORM 

ASSIGN TO DSK 

ACCESS MODE IS SEQUENTIAL 

PROCESSING MODE IS SEQUENTIAL. 



4025 PROGRAMMER'S REFERENCE 



C-1 



APPENDIX C 



006000 








006500 








006600 


DATA DIVISION. 






006700 








006800 








006900 








007000 


FILE SECTION. 






007200 








007300 


FD TEK-FORM 






007400 


VALUE OF ID IS 'DATA SEQ' 


007500 


DATA RECORD IS TEK-FORM-DATA. 


007600 


01 TEK-FORM-DATA 




USAGE IS DISPLAY-7 


007700 


02TF-REF 




PICX(10). 


007800 


02 TF-CUST. 






007900 


03TF-CUST-1 




PICX(4). 


008000 


03 TF-CUST-2 




PICXOO). 


008100 


02TF-INSTRUMENT 




PICX(8). 


008200 


02 TF-VALUE 




PICX(8). 


008300 


02 TF-TYPE 




PICX(5). 


008400 


02 TF-FC-AMOUNT 




PICX(13). 


008500 


02 TF-RATE 




PICX(12). 


008600 


02 TF-DOLLARS 




PICX(15). 


008700 


02TF-OUR-ACCT 




PICX(4). 


008800 


02 TF-CONTRACT-NR 




PICX(8). 


008900 


02 TF-CREDIT-REFERENCE 


PICX(12). 


009000 


02 TF-CHECK-OK 




PICX(1). 


011000 








011900 


WORKING-STORAGE SECTION. 




012000 








012200 








012300 


01 TEK-FORM-FILL-OUT 


USAGE IS DISPLAY-7 


012400*-: 








012500 








012600 


02 TFFO-0 


PIC X(33) VALUE IS 


012700 


'!FORN;!BUF;!WOR24KH;! 


!JUM;!ERA'. 


012800 


02 TFFO-1 


PIC X(1 2) VALUE IS 


01 2900 


'!JUM;!ATTIP'. 






013000 








013100 


02 TFFO-1 A 


PIC X(1 9) VALUE IS 


013200 


'!JUM1,11;T E K '. 






013300 








013400 


02 TFFO-1 B 


PIC X(33) VALUE IS 


013500 


'!JUM 1 ,27;SAMPLE OF FORM FILL OUT. 
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013600 

013700 

013800 

01 3900* 

01 4000 

014100 

014200 

014300 

014400 



02TFFO-1C PIC X(27) VALUE IS 

'!JUM1,79; !ATT PS;!JUM 3,1'. 

02 TFFO-3 PIC X(1 9) VALUE IS 

'!ATT P;REF !JUM 3,6'. 

02 TFFO-3A PIC X(27) VALUE IS 

'IATTEA; IJUM3.16". 



014600 

014700 

014800 

014900 

015000 

015100 

015200 

015300 

015400 

015500 

01 5600 

015700 

015800* 

015900* 

016100* 

016200 

016300 

016400 

016500 

016600 

016700 

016800 

016900 

017000 

017100 

017200 

017300 

01 8000* 

018100* 

018200* 

018400* 

018500 

018600 



02 TFFO-3B PIC X(36) VALUE IS 

'IATT PS; CUST IATTEA; !ATT PS'. 

02 TFFO-3C PIC X(27) VALUE IS 

' IATT EA;!JUM 3,39; !ATT PS'. 

02 TFFO-3D PIC X(46) VALUE IS 

' INSTRUMENT IATT EA; !ATT PS;!JUM 3,61'. 

02 TFFO-3E PIC X(33) VALUE IS 

' VALUE DT IATT EA; IATT PS'. 



LINE 5 



02TFFO-5 PIC X(55) VALUE IS 

■!JUM5;!ATTPS; TYPE IATTEA; !JUM 5,1 7;!ATT PS'. 

02 TFFO-5A PIC X(45) VALUE IS 

' F/C AMT UUM 5,27;!ATT AE;!JUM 5,40; IATT PS'. 

02 TFFO-5B PIC X(33) VALUE IS 

' RATE IATT EA;!JUM 5,60; IATT PS'. 

02 TFFO-5C PIC X(30) VALUE IS 

' $ IATT ENIJUM 5,79; IATT PS'. 



LINE 7 



02 TFFO-7 



PIC X(45) VALUE IS 
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018700 


'!JUM7;!ATTPS; OUR 


ACCT !ATT AE; !ATT PJ 


018800 






01 8900 


02 TFFO-7A 


PIC X(30) VALUE IS 


019000 


'CONT#!ATTAE; 


!ATT PS'. 


019100 






019200 


02TFFO-7B 


PIC X(46) VALUE IS 


019300 


' CREDIT REFERENCE* !ATT AE;!JUM 7,62; !A _ 


019400 






019500 


02 TFFO-7C 


PIC X(29) VALUE IS 


019600 


' CHECK OK IATTAE 


; !ATT PS'. 


019700 






030100* 






030200* 


LINE 23: SPECIAL END OF SCREEN DATA FLAG 


030300* 






030400 


02 TFFO-EOD-FLAG 


PIC X(45) VALUE IS 


030500 


'!JUM23;!ATTPM;01'. 




030600* 






030700* 


FORM END 




030800* 






030900 


02 TFFO-END 


PIC X(1 3) VALUE IS 


031000 


'!JUM3,6;!FOR'. 




031100 






031200 


01 TERMINAL-DATA 


USAGE IS DISPLAY-7. 


031300*- = 






031 400 






031 500 


02 TD-LOCATION. 




031600 


03 TD-LOC-ROW 


PIC X(3). 


031700 


03 FILLER 


PICX. 


031800 


03 TD-LOC-COL 


PIC X(3). 


031900 


02 TD-DATA 


PIC X(40). 


032000 






032100 


01 INDICATORS. 




032200*- = 






032300 






032400 


02 END-OF-JOB-IND PIC X(3). 


032500 


88 END-OF-JOB 


VALUE IS 'EOJ' 


032600 






032700 


02 LINE-IS-EMPTY-IND PIC X(3). 


032800 


88 LINE-IS-EMPTY VALUE IS 'EOL' 
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032900 

033000 01 CONSTANTS. 

033100* = = = = = = = = = = = = = = 

033200 

033300 02 PROMPT-4025 PIC X VALUE IS '?'. 

033400 

033500 01 VARIABLES. 

033600* = = = = = = = = = = = = = = 

033700 

033800 02 TiMES-SCREEN-RESET PiC 9(2). 

034100 PROCEDURE DIVISION. 

034200* 

034400 

034600 INITIALIZATION. 

034800 

034900 OPEN OUTPUT TEK-FORM. 

035000 MOVE SPACES TO TEK-FORM-DATA. 

0351 00 PERFORM TERMINAL-SET-UP. 

035200 PERFORM DISPLAY-THE-FORM. 

035400 

035500 

035700 MAIN-PART. 

035900 

036000 MOVE SPACES TO END-OF-JOB-IND. 

036100 PERFORM PROCESS-THE-TERMINAL-DATA UNTIL END-OF-JOB. 

036200* FLUSH THE LINE 23 FIELD STILL BUFFERED UP 

036300 DISPLAY PROMPT-4025. 

036310 ACCEPT TERMINAL-DATA. 

036320 DISPLAY PROMPT-4025. 

036330 ACCEPT TERMINAL-DATA. 

036400 CLOSE TEK-FORM. 

036500 PERFORM TERMINAL-SET-DOWN. 

036600 STOP RUN. 

036700* < < LOGICAL END OF PROGRAM > > 

037000 PROCESS-THE-TERMINAL-DATA. 

037200* = = = = = = = = = = = = = = 

037200 

037300 MOVE SPACES TO TERMINAL-DATA. 

037400 PERFORM GET-BUFFER-LINE. 

037500 

037600 MOVE SPACES TO LINE-IS-EMPTY-IND 

037700 PERFORM DISASSEMBLE-4025-INPUT UNTIL 
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037800 

037900 

038000 

038100 

038200 

038300 

038400 

038500 

038600 

038700* 

038800 

039010*= 

039000 

0391 20* 

039130* 

039100* 

039200* 

039300* 

039400* 

039500 

039600 

039700 

039800 

039900 

040000 

040200 

040210*= 

040400 

040500* 

040600* 

040700* 

040800* 

040900* 

041000* 

041100* 

041210* 

041220* 

041200 

041300 

041400 

041500 

041600 



LINE-IS-EMPTY 
IF NOT END-OF-JOB 

WRITE TEK-FORM-DATA 

DISPLAY PROMPT-4025 

MOVE SPACES TO TEK-FORM-DATA 

DISPLAY PROMPT-4025 
ELSE 

NEXT SENTENCE. 
DISPLAY '!ERA;!BEL'. 



TERMINAL-SET-UP. 



IT IS BEST TO SET THE 4025 TO A KNOWN STATE 

RATHER THAN TO ASSUME WHAT STATE IT IS IN. 

SET PROMPT := <?><CARRIAGE-RETURN><LINE-FEED> 

SETF1 ■= <CARRIAGE-RETURNXLINE-FEED> 

SET PT := <SEND MODIFIED> 

SET FIELD-SEPERATOR := <CARRIAGE-RETURN> 

DISPLAY '!PRO 63,1 3,10'. 

DISPLAY 'ILEA F1 13,10". 

DISPLAY 'ILEA PT /!REP 1 ;!SEN MOD 1 A3'. 

DISPLAY '!FIE 13'. 

TERMINAL-SET-DOWN. 



PURPOSE: 

RETURN THE 4025 TO COMMUNICATION WITH THE HOST, 

THE KEYBOARD TO THE MONITOR SPACE, NON-FORM FILL 

OUT, UNBUFFERED, ALL FUNCTION AND OTHER KEYS 

UN-LEARNED, AND DISPLAY IN THE MONITOR SPACE OF 

THE 4025 A MESSAGE SAYING WHAT HAS BEEN DONE. 

IN THIS WAY, IT IS POSSIBLE FOR THE USER TO 

COMMUNICATE WITH THE COMPUTER WITHOUT LOSING THE LAST SCREEN. 

DISPLAY 'IFOR N;!BUF N;!MON K H". 

DISPLAY 'ICLEAR'. 

DISPLAY '<< END OF TEK FORM FILLOUT EXAMPLE >>'. 
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041800 

041810* : 

042000* 

042010* 

042020* 

042300 

042400 

042500 

042510 

043000 

043010*= 

043200 

043300* 

043400* 

043500* 

043600* 

043700* 

043800* 

043900* 

044100* 

044200* 

044300* 

044400* 

044500* 

044600* 

044700* 

044800 

044900 

045000 

045100 

045200 

045210 

045220 

045230 

045300 

046800* 

046900* 

047000* 

047100* 

047200* 

047300* 

049800 

049900 



GET-BUFFER-LINE. 

SINCE INFORMATION IS 'BUFFERED' , IT IS NECESSARY TO 
'PROMPT THE 4025 TO SEND THE DATA AND THEN WAIT 
FOR IT TO BE SENT. 

DISPLAY PROMPT-4025. 
ACCEPT TERMINAL-DATA. 

DISASSEMBLE-4025-INPUT. 



THIS SECTION IS A 'CASE' STATEMENT THT EXAMINES 
THE DATA FROM THE 4025 AND PERFORMS A ROUTINE 
WHICH FURTHER EXAMINES THE LINE. 

CASE TD-LOC-ROW OF 

'003' : PERFORM ROW 3 PROCESSING 
'005' : PERFORM ROW 5 PROCESSING 
'023' : PERFORM ROW 23 PROCESSING 
' ' : SET LINE INDICATOR TO 'EMPTY' 

WHEN THE PROTECTED MODIFIED FIELD ON LINE 23 IS 
PROCESSED, EOL IS SET TRUE AND THE BUFFER CONSIDERED 
PROCESSED. THE WHOLE PROCESS STARTS OVER AGAIN AND 
A NEW BUFFER IS PROCESSED. 
IF TD-LOC-ROW = '003' 
PERFORM ROW-3 

ELSE IF TD-LOC-ROW = '005' 
PERFORM ROW-5 

ELSE IF TD-LOC-ROW = '023' 
PERFORM ROW-23. 

NOTE: IF ADDITIONAL LINES EXIST ON THE FORM 

ADDITIONAL 'ELSE IF' LINES MAY BE CODED. 
HOWEVER, THERE IS A LIMIT TO THE DEPTH TO WHICH 
MOST COMPILERS WILL ALLOW IPS TO BE NESTED. 
TO OVERCOME THE NESTING LIMIT, START UP ANOTHER 
'IF...THEN...ELSE'. 

IF LINE-IS-EMPTY 
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050000 

050200 

050300 

050500' 

050600* 

050700* 

050800* 

050900* 

051000* 

051100* 

051200* 

051700* 

051800* 

051900 

052000****** 

052100 ROW 

052200 ** 

052300 

052400 

052500 

052600 

052700 

052800 

052900 

053000 

053100 

053200 

053300 

053400 

053500 

053600 

053700 

053800 

053900 

054000 

054100 

054200 

054300 

054400 

054500 

054600 

054700 

054800 * 



NEXT SENTENCE 

ELSE PERFORM GET-BUFFER-LINE. 



WORK ROUTINES 

THESE ROUTINES FURTHER BREAK DOWN THE DATA JUST 
RECEIVED FROM THE 4025 TERMINAL EACH OF THE 
ROUTINES THAT FOLLOW IS DEDICATED TO ONE ROW FROM 
THE 4025. THESE ROUTINES WILL EXAMINE THE COLUMN 
NUMBER AND TAKE APPROPRIATE ACTION. IN THIS PROGRAM 
THE DATA IS JUST SAVED IN A DISC FILE BUT ADDITIONAL 
PROCESSING COULD HAVE BEEN DONE. 



-3. 



IF TD-LOC-COL = '006' 

MOVE TD-DATA TO TF-REF 

ELSE IF TD-LOC-COL = '025' 
MOVE TD-DATA TO TF-CUST-1 

ELSE IF TD-LOC-COL = '030' 
MOVE TD-DATA TO TF-CUST-2 

ELSE IF TD-LOC-COL = '053' 

MOVE TD-DATA TO TF-INSTRUMENT 

ELSE IF TD-LOC-COL = '071 ' 
MOVE TD-DATA TO TF-VALUE 

ELSE 

NEXT SENTENCE. 

IF TF-REF = 'QUIT' 

MOVE 'EOL' TO LINE-IS-EMPTY-IND 
MOVE 'EOJ' TO END-OF-JOB-IND 

ELSE 

NEXT SENTENCE. 



C-8 



@ 



4025 PROGRAMMER'S REFERENCE 



APPENDIX C 



^******** 



055000******* 

055100 

055200 

055300 

055400 

055500 

055600 

055700 

055800 

055900 

056000 

056100 

056200 

056300 

056400 

056500 

056600 

056700******* 

056800 ROW- 

056900' 

057100 

057200 

057300 

057400 

057500 

057600 

057700 

057800 

057900 

058000 

058100 

058200 

058300 

058400 

058500 

068100 

068200*' 

068300 ROW-23. 

068400******** 

068500 

068600 

068700 



IFTD-LOC-COL = '011' 

MOVE TD-DATA TO TF-TYPE 

ELSE IFTD-LOC-COL = '027' 
MOVE TD-DATA TO TF-FC-AMOUNT 

ELSE IF TD-LOC-COL = '048' 
MOVE TD-DATA TO TF-RATE 

ELSE IF TD-LOC-COL - '066' 

MOVE TD-DATA TO TF-DOLLARS 

ELSE 

NEXT SENTENCE. 



7. 



IFTD-LOC-COL = '012' 

MOVE TD-DATA TO TF-OUR-ACCT 

ELSE IFTD-LOC-COL = '023' 

MOVE TD-DATA TO TF-CONTRACT-NR 

ELSE IFTD-LOC-COL = '051' 

MOVE TD-DATA TO TF-CREDIT-REFERENCE 

ELSE IFTD-LOC-COL = '076' 

MOVE TD-DATA TO TF-CHECK-OK 

ELSE 

NEXT SENTENCE. 



******** 



MOVE 'EOL' TO LINE-IS-EMPTY-IND. 
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068800 

071300*= 

071400 

071500 

071600 

071700 

071800 

071900 

072000 

072100 

072200 

072300 

072400 

072500 

072600 

072700 

072800 

072900 

073100 

073200 

073300 

073400 

075600 

075700* 

075800* 

075900 

076000* 

076100* 



DISPLAY-THE-FORM. 



DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 
DISPLAY 



TFFO-0. 

TFFO-1. 

TFFO-1A. 

TFFO-1 B. 

TFFO-1 C. 

TFFO-3. 

TFFO-3A. 

TFFO-3B. 

TFFO-3C. 

TFFO-3D. 

TFFO-3E. 

TFFO-5. 

TFFO-5A. 

TFFO-5B. 

TFFO-5C. 

TFFO-7. 

TFFO-7A. 

TFFO-7B. 

TFFO-7C. 

TFFO-EOD-FLAG. 



DISPLAY TFFO-END. 



< < PHYSICAL END OF PROGRAM > > 
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